WDF_USB_CONTROL_SETUP_PACKET_INIT 함수(wdfusb.h)

아티클
08/08/2023

[KMDF 및 UMDF에 적용]

WDF_USB_CONTROL_SETUP_PACKET_INIT 함수는 표준 USB 제어 전송을 위해 WDF_USB_CONTROL_SETUP_PACKET 구조를 초기화합니다.

구문

void WDF_USB_CONTROL_SETUP_PACKET_INIT(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_DIRECTION   Direction,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   Recipient,
  [in]  BYTE                          Request,
  [in]  USHORT                        Value,
  [in]  USHORT                        Index
);

매개 변수

[out] Packet

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

[in] Direction

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

[in] Recipient

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

[in] Request

WDF_USB_CONTROL_SETUP_PACKET 구조체의 Packet.bRequest 멤버에 저장된 요청 형식 상수입니다.

[in] Value

WDF_USB_CONTROL_SETUP_PACKET 구조체의 Packet.wValue.Value 멤버에 저장된 요청별 값입니다.

[in] Index

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

반환 값

없음

설명

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

WDF_USB_CONTROL_SETUP_PACKET 구조체를 0으로 설정합니다 .
Packet.bm.Request.Type 멤버를 BmRequestStandard로 설정합니다.
WDF_USB_CONTROL_SETUP_PACKET_INIT 함수의 입력 인수를 사용하여 다른 구조체 멤버를 설정합니다.

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(
                                  &packet,
                                  BMREQUEST_HOST_TO_DEVICE,
                                  BMREQUEST_TO_DEVICE,
                                  0,
                                  0,
                                  0
                                  );