HidD_GetManufacturerString函式 (hidsdi.h)

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 集合。