WdfUsbTargetDeviceQueryUsbCapability 関数 (wdfusb.h)

[KMDF と UMDF に適用]

WdfUsbTargetDeviceQueryUsbCapability メソッドは、ホスト コントローラーと USB ドライバー スタックが特定の機能をサポートしているかどうかを判断します。

構文

NTSTATUS WdfUsbTargetDeviceQueryUsbCapability(
  [in]            WDFUSBDEVICE UsbDevice,
  [in]            const GUID   *CapabilityType,
  [in]            ULONG        CapabilityBufferLength,
  [out, optional] PVOID        CapabilityBuffer,
  [out, optional] PULONG       ResultLength
);

パラメーター

[in] UsbDevice

USB デバイス オブジェクトへのハンドル。

[in] CapabilityType

クライアント ドライバーが情報を取得する機能を表す GUID へのポインター。 使用可能な PGUID 値は次のとおりです。

• GUID_USB_CAPABILITY_CHAINED_MDLS
• GUID_USB_CAPABILITY_STATIC_STREAMS
• GUID_USB_CAPABILITY_SELECTIVE_SUSPEND
• GUID_USB_CAPABILITY_FUNCTION_SUSPEND
• GUID_USB_CAPABILITY_DEVICE_CONNECTION_HIGH_SPEED_COMPATIBLE
• GUID_USB_CAPABILITY_DEVICE_CONNECTION_SUPER_SPEED_COMPATIBLE

[in] CapabilityBufferLength

CapabilityBuffer が指すバッファーの長さ (バイト単位)。

[out, optional] CapabilityBuffer

要求された USB 機能を受信するための呼び出し元によって割り当てられたバッファーへのポインター。 このパラメーターは省略可能です。 CapabilityBufferLength が 0 の場合、このパラメーターは NULL である必要があります。 同様に、 CapabilityBufferLength が 0 以外の場合は、このパラメーターを指定する必要があります。 このパラメーターは、USBD_QueryUsbCapability ルーチンの OutputBuffer パラメーターに対応します。

[out, optional] ResultLength

返される機能のサイズ (バイト単位) を含む場所へのポインター。 このパラメーターは省略できます。

戻り値

WdfUsbTargetDeviceQueryUsbCapability は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは次のいずれかの値を返すことができます。

このメソッドは、他の NTSTATUS 値を返す場合もあります。

注釈

WdfUsbTargetDeviceQueryUsbCapability を呼び出す前に、ドライバーは WdfUsbTargetDeviceCreateWithParameters を呼び出して、基になる USB ドライバー スタックに登録する必要があります。

WdfUsbTargetDeviceQueryUsbCapability は、ドライバーの EvtDevicePrepareHardware コールバック関数が呼び出された後に呼び出す必要があります。

次の表では、KMDF ベースの USB クライアント ドライバーが WdfUsbTargetDeviceQueryUsbCapability 呼び出しを介してクエリを実行できる USB 固有の機能について説明します。

要件

こちらもご覧ください

USBD_QueryUsbCapability

WdfUsbTargetDeviceRetrieveInformation