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
Header	wdfusb.h (Wdfusb.h を含む)
Library	Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、 UsbKmdfIrql(kmdf)、 UsbKmdfIrql2(kmdf)、UsbKmdfIrqlExplicit(kmdf)

こちらもご覧ください

WdfUsbTargetDeviceCreateWithParameters