struktur _URB_CONTROL_FEATURE_REQUEST (usb.h)

  • Artikel

Struktur _URB_CONTROL_FEATURE_REQUEST digunakan oleh driver klien USB untuk mengatur atau menghapus fitur pada perangkat, antarmuka, atau titik akhir.

Sintaks

struct _URB_CONTROL_FEATURE_REQUEST {
  struct _URB_HEADER   Hdr;
  PVOID                Reserved;
  ULONG                Reserved2;
  ULONG                Reserved3;
  PVOID                Reserved4;
  PMDL                 Reserved5;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  USHORT               Reserved0;
  USHORT               FeatureSelector;
  USHORT               Index;
  USHORT               Reserved1;
};

Anggota

Hdr

Penunjuk ke struktur _URB_HEADER yang menentukan informasi header URB. Hdr.Function menunjukkan satu set atau operasi fitur yang jelas, untuk dilakukan pada perangkat, antarmuka, titik akhir, atau komponen non-standar lainnya. Hdr.Function harus memiliki salah satu nilai berikut:

Hdr.Length harus sama dengan sizeof(_URB_CONTROL_FEATURE_REQUEST).

Reserved

Dicadangkan. Jangan gunakan.

Reserved2

Dicadangkan. Jangan gunakan.

Reserved3

Dicadangkan. Jangan gunakan.

Reserved4

Dicadangkan. Jangan gunakan.

Reserved5

Dicadangkan. Jangan gunakan.

UrbLink

Dicadangkan. Jangan gunakan.

hca

Dicadangkan. Jangan gunakan.

Reserved0

Dicadangkan. Jangan gunakan.

FeatureSelector

Menentukan kode fitur yang ditentukan USB untuk dibersihkan atau diatur. Menggunakan kode fitur yang tidak valid, tidak dapat diatur, atau tidak dapat dibersihkan akan menyebabkan target dipungut. Driver bus akan menyalin nilai di anggota FeatureSelector ke bidang wValue dari paket penyiapan.

Index

Menentukan indeks yang ditentukan perangkat, dikembalikan oleh permintaan konfigurasi yang berhasil, jika permintaannya adalah untuk titik akhir atau antarmuka. Jika tidak, Indeks harus nol. Driver bus akan menyalin nilai di anggota Indeks ke bidang wIndex dari paket penyiapan.

Reserved1

Dicadangkan. Jangan gunakan.

Keterangan

Driver dapat menggunakan rutinitas layanan UsbBuildFeatureRequest untuk memformat URB ini.

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

Ketika driver mempersenjatai perangkat USB untuk bangun jarak jauh dengan permintaan IRP_MN_WAIT_WAKE, driver bus USB secara otomatis mengatur fitur bangun jarak jauh pada perangkat. URB fitur kontrol tidak diperlukan.

Demikian juga, ketika pengemudi mengeluarkan URB dengan jenis fungsi URB_FUNCTION_SYNC_RESET_PIPE_AND_CLEAR_STALL ke pipa, pengemudi bus akan secara otomatis menghapus fitur stall titik akhir pipa. Driver tidak perlu mengirim URB fitur kontrol ke pipa untuk menghapus stall titik akhir.

Persyaratan

Persyaratan Nilai
Header usb.h (termasuk Usb.h)

Lihat juga

URB

Struktur USB

_URB_HEADER