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 構造体を初期化するには、ドライバーは次のいずれかの関数を呼び出す必要があります。

• 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_BMREQUEST_DIRECTION

WDF_USB_BMREQUEST_RECIPIENT

WDF_USB_BMREQUEST_TYPE

WdfUsbTargetDeviceFormatRequestForControlTransfer

WdfUsbTargetDeviceSendControlTransferSynchronously を する