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 포함)

추가 정보

WDF_USB_BMREQUEST_DIRECTION

WDF_USB_BMREQUEST_RECIPIENT

WDF_USB_BMREQUEST_TYPE

WdfUsbTargetDeviceFormatRequestForControlTransfer

WdfUsbTargetDeviceSendControlTransferSynchronously