WdfUsbTargetDeviceGetInterface 関数 (wdfusb.h)

[KMDF と UMDF に適用]

WdfUsbTargetDeviceGetInterface メソッドは、指定されたインターフェイス インデックスに関連付けられているフレームワーク USB インターフェイス オブジェクトへのハンドルを返します。

構文

WDFUSBINTERFACE WdfUsbTargetDeviceGetInterface(
  [in] WDFUSBDEVICE UsbDevice,
  [in] UCHAR        InterfaceIndex
);

パラメーター

[in] UsbDevice

WdfUsbTargetDeviceCreateWithParametersへの以前の呼び出しから取得された USB デバイス オブジェクトへのハンドル。

[in] InterfaceIndex

現在の構成の USB インターフェイス オブジェクトを指定する 0 から始まるインデックス値。 このインデックス値は、USB 仕様で定義されているインターフェイス番号と同じでない場合があります。

戻り値

WdfUsbTargetDeviceGetInterface USB インターフェイス オブジェクトへのハンドルを返します。 InterfaceIndex 値が無効な場合、このメソッドは NULL 返します。

ドライバーが指定したオブジェクト ハンドルが無効な場合、バグ チェックが発生します。

備考

WdfUsbTargetDeviceGetInterface メソッドと USB I/O ターゲットの詳細については、「USB I/O ターゲットを参照してください。

例

次のコード例では、フレームワークが USB デバイス用に作成した最初の USB インターフェイス オブジェクトへのハンドルを取得します。 次に、インターフェイス オブジェクトに関連付けられているエンドポイントの数を取得します。

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

UsbInterface = WdfUsbTargetDeviceGetInterface(
                                              deviceContext->UsbTargetDevice,
                                              0
                                              );
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

必要条件

要件	価値
ターゲット プラットフォーム の	万国
最小 KMDF バージョン	1.0
UMDF の最小バージョン を する	2.0
ヘッダー	wdfusb.h (Wdfusb.h を含む)
ライブラリ	Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則 を する	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExp usbKmdfIrql(kmdf) , usbKmdfIrql2(kmdf) , UsbKmdfIrqlExplicit(kmdf)

関連項目

WdfUsbTargetDeviceCreateWithParameters