WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE 함수(wdfusb.h)

아티클
08/08/2023

[KMDF 및 UMDF에 적용]

WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE 함수는 디바이스 기능을 설정하거나 지우는 USB 제어 전송에 대한 WDF_USB_CONTROL_SETUP_PACKET 구조를 초기화합니다.

구문

void WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   BmRequestRecipient,
  [in]  USHORT                        FeatureSelector,
  [in]  USHORT                        Index,
  [in]  BOOLEAN                       SetFeature
);

매개 변수

[out] Packet

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

[in] BmRequestRecipient

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

[in] FeatureSelector

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

[in] Index

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

[in] SetFeature

TRUE인 경우 지정된 기능이 설정됨을 나타내는 부울 값입니다. FALSE이면 지정된 기능이 지워질 것입니다.

반환 값

없음

설명

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

WDF_USB_CONTROL_SETUP_PACKET 구조체를 0으로 설정합니다 .
Packet.bm.Request.Type 멤버를 BmRequestStandard로 설정합니다.
Packet.bm.Request.Dir 멤버를 BmRequestDeviceToDevice로 설정합니다.
SetFeature 인수에 따라 Packet.bRequest 멤버를 "기능 설정" 또는 "명확한 기능" 요청 값으로 설정합니다.
WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE 함수의 입력 인수를 사용하여 다른 구조체 멤버를 설정합니다.

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