HidD_GetManufacturerString
常式會傳回
最上層集合的
內嵌字串，以識別製造商。
BOOLEAN HidD_GetManufacturerString(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
[in] HidDeviceObject
指定最上層集合的開啟控制碼。
[out] Buffer
常式用來傳回集合製造商字串之呼叫端配置的緩衝區指標。 常式會以人類可讀的格式傳回 Null 終止的寬字元字串。
[in] BufferLength
指定在 Buffer上提供之呼叫端配置緩衝區的長度，以位元組為單位。 如果緩衝區不夠大，無法傳回整個 Null 終止的內嵌字串，則常式不會在緩衝區中傳回任何內容。 提供的緩衝區必須是 < = 4093 個位元組， (2^12 – 3 個) 。
如果傳回整個 Null 終止的內嵌字串，HidD_HidD_GetManufacturerString傳回 TRUE 。 否則，常式會傳回 FALSE。 使用 GetLastError 取得擴充的錯誤資訊。
只有使用者模式應用程式可以呼叫 HidD_GetManufacturerString。 核心模式驅動程式可以使用 IOCTL_HID_GET_MANUFACTURER_STRING 要求。
內嵌字串中可能的最大字元數是裝置特定的。 對於 USB 裝置，字串長度上限為 126 個字元， (不包含終止的 Null 字元) 。
如果提供的緩衝區不是 < = 4093 個位元組 (2^12 – 3) 呼叫可能會根據基礎通訊協定而失敗 (，HID/Bluetooth/SPI) ，並出現錯誤碼ERROR_GEN_FAILURE (0x0000001f) 。
如需詳細資訊，請參閱 HID 集合。
IOCTL_HID_GET_INDEXED_STRING
IOCTL_HID_GET_MANUFACTURER_STRING
IOCTL_HID_GET_PRODUCT_STRING
IOCTL_HID_GET_SERIALNUMBER_STRING
