struktur _URB_OS_FEATURE_DESCRIPTOR_REQUEST (usb.h)

  • Artikel

Struktur _URB_OS_FEATURE_DESCRIPTOR_REQUEST digunakan oleh driver hub USB untuk mengambil Deskriptor Fitur Microsoft OS dari perangkat USB atau antarmuka pada perangkat USB.

Sintaks

struct _URB_OS_FEATURE_DESCRIPTOR_REQUEST {
  struct _URB_HEADER   Hdr;
  PVOID                Reserved;
  ULONG                Reserved0;
  ULONG                TransferBufferLength;
  PVOID                TransferBuffer;
  PMDL                 TransferBufferMDL;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  UCHAR                Recipient : 5;
  UCHAR                Reserved1 : 3;
  UCHAR                Reserved2;
  UCHAR                InterfaceNumber;
  UCHAR                MS_PageIndex;
  USHORT               MS_FeatureDescriptorIndex;
  USHORT               Reserved3;
};

Anggota

Hdr

Penunjuk ke struktur _URB_HEADER yang menentukan informasi header URB. Hdr.Function harus URB_FUNCTION_GET_MS_FEATURE_DESCRIPTOR. Hdr.Length harus sizeof(_URB_OS_FEATURE_DESCRIPTOR_REQUEST).

Reserved

Reserved0

TransferBufferLength

Menentukan panjang, dalam byte, dari buffer yang ditentukan dalam TransferBuffer atau dijelaskan dalam TransferBufferMDL. Driver pengontrol host mengembalikan jumlah byte yang dibaca dalam anggota ini. Implementasi fungsi ini saat ini membatasi ukuran Deskriptor Fitur MS OS maksimum hingga 4 Kilobyte.

TransferBuffer

Pointer ke buffer residen untuk transfer atau NULL jika MDL disediakan di TransferBufferMDL.

TransferBufferMDL

Penunjuk ke MDL yang menjelaskan buffer penduduk atau NULL jika buffer disediakan di TransferBuffer. MDL ini harus dialokasikan dari kumpulan yang tidak dipagasi.

UrbLink

Dicadangkan. Jangan gunakan.

hca

Recipient

Menentukan apakah penerima adalah perangkat USB atau antarmuka pada perangkat USB. Salah satu nilai berikut harus ditentukan:

  • 0 menunjukkan bahwa perangkat USB adalah penerima permintaan.
  • 1 menunjukkan bahwa antarmuka USB adalah penerima permintaan.
  • 2 menunjukkan bahwa titik akhir USB adalah penerima permintaan.

Reserved1

Reserved2

InterfaceNumber

Menunjukkan nomor antarmuka yang merupakan penerima permintaan, jika nilai Anggota penerima adalah 1. Harus diatur ke 0 jika perangkat USB adalah penerima.

MS_PageIndex

Harus diatur ke 0. Indeks halaman halaman 64K dari Deskriptor Fitur MS OS yang akan dikembalikan. Implementasi saat ini hanya mendukung ukuran deskriptor maksimum 4K.

MS_FeatureDescriptorIndex

Indeks untuk Deskriptor Fitur MS OS yang akan diminta.

Reserved3

Keterangan

Anggota yang dicadangkan dari struktur ini harus diperlakukan sebagai buram dan disediakan untuk penggunaan sistem.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows XP dan sistem operasi yang lebih baru.
Header usb.h (termasuk Usb.h)

Lihat juga

URB

_URB_HEADER