IOCTL_HID_READ_REPORT IOCTL (hidport.h)

[アーティクル]
02/29/2024

IOCTL_HID_READ_REPORT要求は、HIDClass デバイスから HID クラスドライバーのバッファーに入力レポートを転送します。

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

メジャーコード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

Parameters.DeviceIoControl.OutputBufferLength には、Irp-UserBuffer> で提供されるバッファーのサイズが含まれています。

入力バッファーの長さ

OutputBufferLength のサイズ

出力バッファー

HID ミニドライバーは、Irp-UserBuffer> が指すシステム常駐バッファーに、デバイスから取得されたレポートデータを入力します。

出力バッファーの長さ

UserBuffer のサイズ。

ステータスブロック

デバイスへの I/O を実行する HID ミニドライバーは、Irp-IoStatus> の次のフィールドを設定します。

情報は、デバイスから転送されたバイト数に設定されます。
転送がエラーなしで完了した場合、状態はSTATUS_SUCCESSに設定されます。それ以外の場合は、適切な NTSTATUS エラーコードに設定されます。

この IRP を使用して他のドライバーを呼び出してデバイスに I/O を実行する HID ミニドライバーは、状態ブロックの [情報 ] フィールドが正しいことを確認し、[ 状態] フィールドの内容を変更しないようにする必要があります。

注釈

IOCTL_HID_READ_REPORTは、通常、デバイスから送信される入力レポートを継続的に完了するために使用されます。この IOCTL は、PING ポン方式で HID クラスドライバー (HIDCLASS) によって送信されます。つまり、要求が満たされるとすぐに (完了)、別の要求をデバイスに送信して、データを継続的にレポートできます。これは "非同期" メカニズムであるため、たとえば、デバイスはそれを使用して、変更が発生した状態の変化に関するデータをホストに送信できます。