_URB_OS_FEATURE_DESCRIPTOR_REQUEST Struktur (usb.h)
Die _URB_OS_FEATURE_DESCRIPTOR_REQUEST Struktur wird vom USB-Hubtreiber verwendet, um Microsoft OS Feature Descriptors von einem USB-Gerät oder einer Schnittstelle auf einem USB-Gerät abzurufen.
Syntax
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;
};
Angehörige
Hdr
Zeigen Sie auf eine _URB_HEADER Struktur, die die URB-Headerinformationen angibt.
Hdr.Function- müssen URB_FUNCTION_GET_MS_FEATURE_DESCRIPTOR.
Hdr.Length- muss sizeof(_URB_OS_FEATURE_DESCRIPTOR_REQUEST)sein.
Reserved
Reserved0
TransferBufferLength
Gibt die Länge des in TransferBuffer angegebenen Puffers in Bytes an oder wird in TransferBufferMDL-beschrieben. Der Hostcontrollertreiber gibt die Anzahl der in diesem Element gelesenen Bytes zurück. Die aktuelle Implementierung dieser Funktion beschränkt die maximale GRÖßE der MS OS-Featurebeschreibung auf 4 KB.
TransferBuffer
Zeiger auf einen residenten Puffer für die Übertragung oder ist NULL-, wenn eine MDL in TransferBufferMDL-bereitgestellt wird.
TransferBufferMDL
Zeiger auf eine MDL, die einen residenten Puffer beschreibt oder NULL- ist, wenn ein Puffer in TransferBuffer-bereitgestellt wird. Diese MDL muss aus nicht seitengebundenen Pools zugewiesen werden.
UrbLink
Reserviert. Nicht verwenden.
hca
Recipient
Gibt an, ob der Empfänger das USB-Gerät oder eine Schnittstelle auf dem USB-Gerät ist. Einer der folgenden Werte muss angegeben werden:
- 0 gibt an, dass das USB-Gerät der Empfänger der Anforderung ist.
- 1 gibt an, dass eine USB-Schnittstelle der Empfänger der Anforderung ist.
- 2 gibt an, dass ein USB-Endpunkt der Empfänger der Anforderung ist.
Reserved1
Reserved2
InterfaceNumber
Gibt die Schnittstellennummer an, die der Empfänger der Anforderung ist, wenn der Recipient Memberwert 1 ist. Muss auf 0 festgelegt werden, wenn das USB-Gerät der Empfänger ist.
MS_PageIndex
Muss auf 0 festgelegt sein. Seitenindex der 64K-Seite des MS OS-Featuredeskriptors, der zurückgegeben werden soll. Die aktuelle Implementierung unterstützt nur eine maximale Deskriptorgröße von 4K.
MS_FeatureDescriptorIndex
Index für ms OS FeatureDeskriptor, der angefordert werden soll.
Reserved3
Bemerkungen
Die reservierten Member dieser Struktur müssen als undurchsichtig behandelt werden und sind für die Systemverwendung reserviert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows XP und höheren Betriebssystemen. |
| Header- | usb.h (include Usb.h) |