IOCTL_HID_GET_INDEXED_STRING IOCTL (hidclass.h)

[アーティクル]
08/07/2023

IOCTL_HID_GET_INDEXED_STRING要求は、最上位のコレクションから指定された埋め込み文字列を取得します。取得された文字列は、人間が判読できる形式の NULL で終わるワイド文字列です。

HIDClass デバイスの一般的な情報については、「 HID コレクション」を参照してください。

メジャーコード

[入力バッファー]

IRP の I/O スタック位置の Parameters.DeviceIoControl.InputBufferLength は、Irp-AssociatedIrp.SystemBuffer> が指す位置にある入力バッファーのサイズをバイト単位で示します。

IRP の I/O スタック位置の Parameters.DeviceIoControl.OutputBufferLength は、出力バッファーのサイズ (バイト単位) を示します。出力バッファーが NULL で終わる埋め込み文字列全体を保持するのに十分な大きさでない場合、要求は出力バッファーに何も返しません。

ミニドライバーの処理: IOCTL_HID_GET_INDEXED_STRINGは 2 つの入力バッファーを使用します。

IRP の I/O スタック位置の Parameters.DeviceIoControl.OutputBufferLength は、Irp-MdlAddress> が指す位置にある出力バッファーのサイズをバイト単位で示します。出力バッファーが NULL で終わる埋め込み文字列全体を保持するのに十分な大きさでない場合、要求は出力バッファーに何も返しません。埋め込み文字列内で使用できる最大文字数は、デバイス固有です。 USB デバイスの場合、文字列の最大長は 126 文字です (終端の NULL 文字は含まれません)。

Parameters.DeviceIoControl.Type3InputBuffer には、取得する文字列を記述する INT 値が含まれています。 INT 値の最上位の 2 バイトには、言語 ID が含まれます (たとえば、値 1033 は英語を示します)。 INT 値の最下位 2 バイトには、文字列インデックスが含まれます。

入力バッファーの長さ

Parameters.DeviceIoControl.InputBufferLength は >= sizeof(ULONG) である必要があり、取得する文字列のインデックスを含める必要があります。

Parameters.DeviceIoControl.OutputBufferLength の場合、埋め込み文字列に含まれる最大文字数はデバイス固有です。 USB デバイスの場合、文字列の最大長は 126 文字です (終端の NULL 文字は含まれません)。

出力バッファー

Irp->MdlAddress は、取得された文字列 (NULL で終わるワイド文字列) を受け取るバッファーを指します。

ミニドライバーの処理: Irp-MdlAddress> は、取得された文字列 (NULL で終わるワイド文字列) を受け取るバッファーを指します。 HID ミニドライバーのほとんどのデバイス制御 IRP とは異なり、この IRP はMETHOD_NEITHERバッファリングを使用しないことに注意してください。特に、出力バッファーが Irp-UserBuffer> によって識別されるIOCTL_HID_GET_STRINGと区別する必要があります。