WDF_USB_CONTROL_SETUP_PACKET 공용 구조체(wdfusb.h)
[KMDF 및 UMDF에 적용]
WDF_USB_CONTROL_SETUP_PACKET 구조는 USB 제어 전송을 위한 설정 패킷을 설명합니다.
구문
typedef union _WDF_USB_CONTROL_SETUP_PACKET {
struct {
union {
struct {
BYTE Recipient : 2;
BYTE Reserved : 3;
BYTE Type : 2;
BYTE Dir : 1;
} Request;
BYTE Byte;
} bm;
BYTE bRequest;
union {
struct {
BYTE LowByte;
BYTE HiByte;
} Bytes;
USHORT Value;
} wValue;
union {
struct {
BYTE LowByte;
BYTE HiByte;
} Bytes;
USHORT Value;
} wIndex;
USHORT wLength;
} Packet;
struct {
BYTE Bytes[8];
} Generic;
} WDF_USB_CONTROL_SETUP_PACKET, *PWDF_USB_CONTROL_SETUP_PACKET;
멤버
Packet
Packet.bm
Packet.bm.Request
Packet.bm.Request.Recipient
WDF_USB_BMREQUEST_RECIPIENT 형식의 값으로 지정된 비트 필드입니다.
Packet.bm.Request.Reserved
예약된 비트 필드입니다. 이 멤버를 사용하지 마세요.
Packet.bm.Request.Type
WDF_USB_BMREQUEST_TYPE 형식의 값으로 지정된 비트 필드입니다.
Packet.bm.Request.Dir
WDF_USB_BMREQUEST_DIRECTION 형식의 값으로 지정된 비트 필드입니다.
Packet.bm.Byte
Request.Recipient, Request.Reserved, Request.Type 및 Request.Dir 비트 필드가 포함된 바이트 크기의 비트맵입니다. 개별 비트 필드를 지정하는 대신 이 멤버를 사용합니다.
Packet.bRequest
요청 유형입니다. 요청 형식 상수는 Usb100.h에 정의되어 있습니다. 요청 유형에 대한 자세한 내용은 USB 사양을 참조하세요.
Packet.wValue
Packet.wValue.Bytes
Packet.wValue.Bytes.LowByte
요청별 2 바이트 값의 낮은 바이트입니다. wValue를 지정하는 방법에 대한 자세한 내용은 USB 사양을 참조하세요.
Packet.wValue.Bytes.HiByte
요청별 2 바이트 값의 상위 바이트입니다.
Packet.wValue.Value
Bytes.LowByte 및 Bytes.HiByte 값을 포함하는 2바이트 값입니다. 개별 로우 바이트 및 하이 바이트 값을 지정하는 대신 이 멤버를 사용합니다.
Packet.wIndex
Packet.wIndex.Bytes
Packet.wIndex.Bytes.LowByte
요청별 2 바이트 값의 낮은 바이트입니다. wValue를 지정하는 방법에 대한 자세한 내용은 USB 사양을 참조하세요.
Packet.wIndex.Bytes.HiByte
요청별 2 바이트 값의 상위 바이트입니다.
Packet.wIndex.Value
Bytes.LowByte 및 Bytes.HiByte 값을 포함하는 2바이트 값입니다. 개별 로우 바이트 및 하이 바이트 값을 지정하는 대신 이 멤버를 사용합니다.
Packet.wLength
해당하는 경우 전송할 바이트 수입니다. 이 값에 대한 자세한 내용은 USB 사양을 참조하세요. 프레임워크는 이 값을 설정합니다.
Generic
Generic.Bytes[8]
전체 설정 패킷을 나타내는 8 바이트 값입니다. 개별 구조체 멤버를 지정하는 대신 이 멤버를 사용할 수 있습니다.
설명
WDF_USB_CONTROL_SETUP_PACKET 구조체는 WdfUsbTargetDeviceSendControlTransferSynchronously 및 WdfUsbTargetDeviceFormatRequestForControlTransfer 메서드에 대한 입력으로 사용됩니다.
WDF_USB_CONTROL_SETUP_PACKET 구조를 초기화하려면 드라이버가 다음 함수 중 하나를 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfusb.h(Wdfusb.h 포함) |