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 드라이버 스택에 등록해야 합니다.

드라이버의 EvtDevicePrepareHardware 콜백 함수가 호출된 후 WdfUsbTargetDeviceQueryUsbCapability를 호출해야 합니다.

다음 표에서는 KMDF 기반 USB 클라이언트 드라이버가 WdfUsbTargetDeviceQueryUsbCapability 호출을 통해 쿼리할 수 있는 USB 관련 기능에 대해 설명합니다.

요구 사항

추가 정보

USBD_QueryUsbCapability

WdfUsbTargetDeviceRetrieveInformation