IOCTL_HID_GET_SERIALNUMBER_STRING IOCTL (hidclass.h)
IOCTL_HID_GET_SERIALNUMBER_STRING要求は、デバイスのシリアル番号を識別する 最上位のコレクションの 埋め込み文字列を取得します。 取得された文字列は、人間が判読できる形式の NULL で終わるワイド文字列です。
HIDClass デバイスの一般的な情報については、「 HID コレクション」を参照してください。
メジャー コード
[入力バッファー]
IRP の I/O スタック位置の Parameters.DeviceIoControl.OutputBufferLength は、出力バッファーのサイズ (バイト単位) を示します。 出力バッファーが NULL で終わる埋め込み文字列全体を保持するのに十分な大きさでない場合、要求は出力バッファーに何も返しません。
入力バッファーの長さ
埋め込み文字列内で使用できる最大文字数は、デバイス固有です。 USB デバイスの場合、文字列の最大長は 126 文字です (終端の NULL 文字は含まれません)。
出力バッファー
Irp->MdlAddress は、シリアル番号文字列 (NULL で終わるワイド文字列) を受け取るバッファーを指します。
出力バッファーの長さ
NULL で終わるワイド文字列の長さ。 指定するバッファーは <、 = 4093 バイト (2^12 – 3) である必要があります。
ステータス ブロック
HID クラス ドライバーは、Irp-IoStatus> の次のフィールドを設定します。
情報 は、デバイスから転送されたバイト数に設定されます。
転送 がエラーなしで完了した場合、状態はSTATUS_SUCCESSに設定されます。 それ以外の場合は、適切な NTSTATUS エラー コードに設定されます。
要件
| 要件 | 値 |
|---|---|
| Header | hidclass.h (Hidclass.h を含む) |