IOCTL_HID_SET_FEATURE IOCTL (hidclass.h)

  • [アーティクル]

IOCTL_HID_SET_FEATURE要求は、機能レポートを 最上位のコレクションに送信します。

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

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

メンバーは Parameters.DeviceIoControl.InputBufferLength 、HID クラスフィーチャ レポートを含むリクエスターによって割り当てられた入力バッファーのサイズ (バイト単位) に設定されます。

入力バッファーのサイズ (バイト単位)。 バッファーは、機能レポートを保持するのに十分な大きさと、0 以外のレポート ID を指定する 1 つの追加バイトである必要があります。 レポート ID を使用しない場合、ID 値は 0 です。

メンバーは Irp->AssociatedIrp.SystemBuffer 、特徴レポートを含む入力バッファーを指します。 コレクションにレポート ID が含まれている場合、要求者はバッファーの最初のバイトを 0 以外のレポート ID に設定する必要があります。それ以外の場合、リクエスターは最初のバイトをゼロに設定する必要があります。 機能レポートは にあります ((PUCHAR)ReportBuffer + 1)。

ミニドライバーの処理

Irp->UserBuffer は 、HID クラス ドライバーが次のメンバーを入力するために使用するHID_XFER_PACKET構造体を指します。

入力バッファーの長さ

入力バッファーのサイズ (バイト単位)。 バッファーは、出力レポートと 0 以外のレポート ID を指定する 1 つの追加バイトを保持するのに十分な大きさである必要があります。 レポート ID を使用しない場合、ID 値は 0 です。

ミニドライバーの処理

HID_XFER_PACKET構造体のサイズ。

出力バッファー

[なし] :

出力バッファーの長さ

[なし] :

ステータス ブロック

HID クラス ドライバーは、 の次のフィールドを Irp->IoStatus設定します。

  • 情報 は 0 に設定されます。
  • 転送 がエラーなしで完了した場合、状態はSTATUS_SUCCESSに設定されます。 それ以外の場合は、適切な NTSTATUS エラー コードに設定されます

ミニドライバーの処理

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

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

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

要件

要件 値
Header hidclass.h (Hidclass.h を含む)

こちらもご覧ください