WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS 함수(wdfusb.h)

아티클
08/08/2023

[KMDF 및 UMDF에 적용]

WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS 함수는 디바이스 상태 가져오는 USB 제어 전송에 대한 WDF_USB_CONTROL_SETUP_PACKET 구조를 초기화합니다.

구문

void WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   BmRequestRecipient,
  [in]  USHORT                        Index
);

매개 변수

[out] Packet

WDF_USB_CONTROL_SETUP_PACKET 구조체에 대한 포인터입니다.

[in] BmRequestRecipient

WDF_USB_CONTROL_SETUP_PACKET 구조체의 Packet.bm.Request.Recipient 멤버에 저장된 WDF_USB_BMREQUEST_RECIPIENT 형식의 값입니다.

[in] Index

WDF_USB_CONTROL_SETUP_PACKET 구조체의 Packet.wIndex.Value 멤버에 저장된 상태 인덱스 값입니다.

반환 값

없음

설명

WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS 함수는 다음을 수행합니다.

WDF_USB_CONTROL_SETUP_PACKET 구조체를 0으로 설정합니다 .
Packet.bm.Request.Type 멤버를 BmRequestStandard로 설정합니다.
Packet.bm.Request.Dir 멤버를 BmRequestDeviceToHost로 설정합니다.
Packet.bRequest 멤버를 "get 상태" 요청 값으로 설정합니다.
Packet.wValue.Value 멤버를 0으로 설정합니다.
Packet->Packet.wIndex.Value 멤버를 Index 인수로 설정합니다.

WDF_USB_CONTROL_SETUP_PACKET 구조를 초기화하려면 드라이버가 다음 함수 중 하나를 호출해야 합니다.

WDF_USB_CONTROL_SETUP_PACKET_INIT
WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS
WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE
WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS
WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR

예제

다음 코드 예제에서는 WDF_USB_CONTROL_SETUP_PACKET 구조를 초기화합니다.

WDF_USB_CONTROL_SETUP_PACKET  packet;

WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS(
                                             &packet,
                                             BmRequestToDevice,
                                             0
                                             );