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