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
ヘッダー	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)