UdecxWdfDeviceTryHandleUserIoctl 関数 (udecxwdfdevice.h)

  • [アーティクル]

ユーザー モード ソフトウェアによって送信された IOCTL 要求の処理を試みます。

構文

BOOLEAN UdecxWdfDeviceTryHandleUserIoctl(
       WDFDEVICE  UdecxWdfDevice,
  [in] WDFREQUEST Request
);

パラメーター

UdecxWdfDevice

コントローラーを表すフレームワーク デバイス オブジェクトへのハンドル。 クライアント ドライバーは、 UdecxWdfDeviceAddUsbDeviceEmulation の前の呼び出しでこのオブジェクトを初期化しました。

[in] Request

IOCTL 要求を表すフレームワーク要求オブジェクトへのハンドル。

戻り値

TRUE は、USB デバイス エミュレーション クラス拡張機能 (UdeCx) が認識され、要求が完了したことを示します (成功または失敗)。 この場合、クライアント ドライバーは要求を完了できません。 それ以外の場合は FALSE。ドライバーは要求を完了する必要があります。

注釈

UDE クライアント ドライバーは、ホスト コントローラー ドライバーとしてユーザー モード ソフトウェアに自身を提示します。 クライアント ドライバーは、GUID_DEVINTERFACE_USB_HOST_CONTROLLERデバイス インターフェイス GUID を登録して公開します。 ユーザー モード ソフトウェアでは、その GUID を指定することで、デバイスへのハンドルを開くことができます。 このハンドルを使用することで、ソフトウェアは IOCTL 要求を送信できます。

メモ 他のインターフェイスの IOCTL コードが USB ホスト コントローラー インターフェイスと重複する可能性があることに注意してください。 このような I/O がこの関数に達すると、IOCTL は正しく処理されません。
 
クライアント ドライバーは、受信した IOCTL を処理する必要はありません。 UdecxWdfDeviceTryHandleUserIoctl を呼び出すことで、クラス拡張機能に要求を送信できます。 クラス拡張機能が要求を標準要求として認識した場合は、その要求を完了します。 それ以外の場合、呼び出しは失敗し、クライアント ドライバーは要求を完了することが期待されます。 処理する必要がある IOCTL の一覧については、「 アプリケーションとサービスの USB IOCTL」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
最小 KMDF バージョン 1.15
Header udecxwdfdevice.h (Udecx.h を含む)
Library Udecxstub.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

アーキテクチャ:USB デバイス エミュレーション (UDE)

UDE クライアント ドライバーを記述する