WDF_USB_CONTROL_SETUP_PACKET union (wdfusb.h)

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_USB_CONTROL_SETUP_PACKET menjelaskan paket penyiapan untuk transfer kontrol USB.

Sintaks

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;

Anggota

Packet

Packet.bm

Packet.bm.Request

Packet.bm.Request.Recipient

Bidang bit yang ditentukan oleh nilai yang WDF_USB_BMREQUEST_RECIPIENT-ketik.

Packet.bm.Request.Reserved

Bidang bit yang dipesan. Jangan gunakan anggota ini.

Packet.bm.Request.Type

Bidang bit yang ditentukan oleh nilai WDF_USB_BMREQUEST_TYPE-ketik.

Packet.bm.Request.Dir

Bidang bit yang ditentukan oleh nilai yang ditik WDF_USB_BMREQUEST_DIRECTION.

Packet.bm.Byte

Bitmap berukuran byte yang berisi bidang bit Request.Recipient, Request.Reserved, Request.Type, dan Request.Dir . Gunakan anggota ini sebagai alternatif untuk menentukan bidang bit individual.

Packet.bRequest

Jenis permintaan. Konstanta jenis permintaan ditentukan dalam Usb100.h. Untuk informasi selengkapnya tentang jenis permintaan, lihat spesifikasi USB.

Packet.wValue

Packet.wValue.Bytes

Packet.wValue.Bytes.LowByte

Byte rendah dari nilai khusus permintaan 2 byte. Untuk informasi selengkapnya tentang menentukan wValue, lihat spesifikasi USB.

Packet.wValue.Bytes.HiByte

Byte tinggi dari nilai khusus permintaan 2 byte.

Packet.wValue.Value

Nilai 2-byte yang berisi nilai Bytes.LowByte dan Bytes.HiByte . Gunakan anggota ini sebagai alternatif untuk menentukan nilai byte rendah dan byte tinggi individu.

Packet.wIndex

Packet.wIndex.Bytes

Packet.wIndex.Bytes.LowByte

Byte rendah dari nilai khusus permintaan 2 byte. Untuk informasi selengkapnya tentang menentukan wValue, lihat spesifikasi USB.

Packet.wIndex.Bytes.HiByte

Byte tinggi dari nilai khusus permintaan 2 byte.

Packet.wIndex.Value

Nilai 2-byte yang berisi nilai Bytes.LowByte dan Bytes.HiByte . Gunakan anggota ini sebagai alternatif untuk menentukan nilai byte rendah dan byte tinggi individu.

Packet.wLength

Jumlah byte yang akan ditransfer, jika berlaku. Untuk informasi selengkapnya tentang nilai ini, lihat spesifikasi USB. Kerangka kerja menetapkan nilai ini.

Generic

Generic.Bytes[8]

Nilai 8-byte yang mewakili seluruh paket penyiapan. Anda dapat menggunakan anggota ini sebagai alternatif untuk menentukan anggota struktur individual.

Keterangan

Struktur WDF_USB_CONTROL_SETUP_PACKET digunakan sebagai input ke metode WdfUsbTargetDeviceSendControlTransferSynchronously dan WdfUsbTargetDeviceFormatRequestForControlTransfer .

Untuk menginisialisasi struktur WDF_USB_CONTROL_SETUP_PACKET , driver harus memanggil salah satu fungsi berikut:

Persyaratan

   
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfusb.h (termasuk Wdfusb.h)

Lihat juga

WDF_USB_BMREQUEST_DIRECTION

WDF_USB_BMREQUEST_RECIPIENT

WDF_USB_BMREQUEST_TYPE

WdfUsbTargetDeviceFormatRequestForControlTransfer

WdfUsbTargetDeviceSendControlTransferSynchronously