WdfUsbInterfaceGetNumSettings 関数 (wdfusb.h)

[KMDF と UMDF に適用]

WdfUsbInterfaceGetNumSettings メソッドは、指定された USB インターフェイスでサポートされている代替設定の数を返します。

構文

BYTE WdfUsbInterfaceGetNumSettings(
  [in] WDFUSBINTERFACE UsbInterface
);

[in] UsbInterface

WdfUsbTargetDeviceGetInterface を呼び出すことによって取得された USB インターフェイスオブジェクトへのハンドル。

WdfUsbInterfaceGetNumSettings は、指定された USB インターフェイスでサポートされている代替設定の数を返します。

ドライバーが無効なオブジェクトハンドルを提供すると、バグチェックが発生します。

WdfUsbTargetDeviceCreateWithParameters を呼び出した後、ドライバーは WdfUsbInterfaceGetNumSettings を呼び出すことができます。

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

次のコード例では、指定した USB インターフェイスで使用できる代替設定の数を取得します。

BYTE altSettings;

altSettings = WdfUsbInterfaceGetNumSettings(UsbInterface);

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.5
最小 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)