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