_URB_OS_FEATURE_DESCRIPTOR_REQUEST-Struktur (usb.h)
Die _URB_OS_FEATURE_DESCRIPTOR_REQUEST-Struktur wird vom USB-Hubtreiber verwendet, um Microsoft-Betriebssystem-Featuredeskriptoren 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;
};
Member
Hdr
Zeiger auf eine _URB_HEADER-Struktur , die die URB-Headerinformationen angibt. Hdr.Function muss URB_FUNCTION_GET_MS_FEATURE_DESCRIPTOR.
Hdr.Length muss sein sizeof(_URB_OS_FEATURE_DESCRIPTOR_REQUEST).
Reserved
Reserved0
TransferBufferLength
Gibt die Länge des in TransferBuffer angegebenen oder in TransferBufferMDL beschriebenen Puffers in Bytes an. Der Hostcontrollertreiber gibt die Anzahl der in diesem Member gelesenen Bytes zurück. Bei der aktuellen Implementierung dieser Funktion wird die maximale Ms OS-Featuredeskriptorgröße auf 4 Kb beschränkt.
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 einem nicht ausseitigen Pool zugeordnet werden.
UrbLink
Reserviert. Darf nicht verwendet werden.
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 werden. Seitenindex der 64K-Seite des zurückzugebenden MS OS-Featuredeskriptors. Die aktuelle Implementierung unterstützt nur eine maximale Deskriptorgröße von 4K.
MS_FeatureDescriptorIndex
Index für ms os feature descriptor to be requested.
Reserved3
Hinweise
Die reservierten Member dieser Struktur müssen als undurchsichtig behandelt werden und sind für die Systemverwendung reserviert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows XP und höheren Betriebssystemen. |
| Kopfzeile | usb.h (usb.h einschließen) |