WDF_USB_CONTROL_SETUP_PACKET union (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