次の方法で共有


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/Bluetooth/SPI によっては)、エラー コードERROR_GEN_FAILURE (0x0000001f)。

詳細については、HID コレクション を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 以降のバージョンの Windows で使用できます。
ターゲット プラットフォーム 万国
ヘッダー hidsdi.h (Hidsdi.h を含む)
ライブラリ Hid.lib
DLL Hid.dll

関連項目

HidD_GetIndexedString

HidD_GetPhysicalDescriptor

HidD_GetProductString

HidD_GetSerialNumberString

IOCTL_HID_GET_INDEXED_STRING

IOCTL_HID_GET_MANUFACTURER_STRING

IOCTL_HID_GET_PRODUCT_STRING

IOCTL_HID_GET_SERIALNUMBER_STRING