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) 。

如果HidD_HidD_GetManufacturerString返回以 NULL 结尾的整个嵌入字符串，则返回 TRUE 。否则，例程返回 FALSE。使用 GetLastError 获取扩展错误信息。

只有用户模式应用程序才能调用 HidD_GetManufacturerString。内核模式驱动程序可以使用 IOCTL_HID_GET_MANUFACTURER_STRING 请求。

嵌入字符串中的最大可能字符数是特定于设备的。对于 USB 设备，最大字符串长度为 126 个宽字符， (不包括终止 NULL 字符) 。

如果提供的缓冲区不 <= 4093 字节 (2^12 – 3) 调用可能会失败 (，具体取决于基础协议，HID/蓝牙/SPI) ERROR_GEN_FAILURE (0x0000001f) 错误代码。

有关详细信息，请参阅 HID 集合。