VhfReadReportSubmit 関数 (vhf.h)

HID ソース ドライバーは、このメソッドを呼び出して、HID 読み取り (入力) レポートを Virtual HID Framework (VHF) に送信します。

構文

NTSTATUS VhfReadReportSubmit(
  [in] VHFHANDLE        VhfHandle,
  [in] PHID_XFER_PACKET HidTransferPacket
);

パラメーター

[in] VhfHandle

VhfCreateへの前の呼び出しで HID ソース ドライバーが受信した仮想 HID デバイスへのハンドル。

[in] HidTransferPacket

HID レポートを記述する HID_XFER_PACKET 構造体へのポインター。

戻り値

VhfReadReportSubmit 呼び出しが成功した場合、メソッドはSTATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS 値です。

備考

HID ソース ドライバーは、そのバッファリング ポリシーを実装するか、Virtual HID Framework (VHF) でバッファリングを処理することを選択できます。

ドライバーが独自のバッファリング ポリシーを使用する場合は、VhfCreateへの呼び出しで、EvtVhfReadyForNextReadReport コールバック関数を実装して登録する必要があります。 VhfReadReportSubmit を呼び出す必要があるのは、VHF が EvtVhfReadyForNextReadReport 呼び出した後に 1 回だけです。 コールバックが呼び出された後、ドライバーは HidTransferPacket によって指転送バッファーを再利用できます。 ドライバーは、このメソッドを再度呼び出す前に、VHF EvtVhfReadyForNextReadReport を呼び出す次の時間を待機する必要があります。

HID ソース ドライバーが EvtVhfReadyForNextReadReport コールバックを実装していない場合、このメソッドの呼び出しに制限はありません。 VHF では、既定のバッファリング ポリシーが使用されます。 ドライバーは、呼び出しが返された後、転送バッファーを再利用できます。

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	vhf.h
ライブラリ	VhfKm.lib
IRQL	<= DISPATCH_LEVEL

関連項目

Virtual HID Framework (VHF) を使用して HID ソース ドライバーを作成する