GetDescriptor-Methode der CIM_USBDevice-Klasse (Hyper-V-Verwaltung)
Gibt den USBDevice-Deskriptor zurück, der von den Eingabeparametern angegeben wird.
Syntax
uint32 GetDescriptor(
[in] uint8 RequestType,
[in] uint16 RequestValue,
[in] uint16 RequestIndex,
[in, out] uint16 RequestLength,
[out] uint8 Buffer[]
);
Parameter
-
RequestType [in]
-
Bitzuordnung, die den Typ der Descriptoranforderung und den Empfänger identifiziert. Der Typ der Anforderung kann "standard", "class" oder "vendor-specific" sein. Der Empfänger kann "Gerät", "Schnittstelle", "Endpunkt" oder "sonstige" sein. Die entsprechenden Werte für jedes Bit finden Sie in der USB-Spezifikation.
-
RequestValue [in]
-
Enthält den Deskriptortyp im hohen Byte und den Deskriptorindex (z. B. Index oder Offset in das Descriptorarray) im niedrigen Byte. Weitere Informationen finden Sie in der USB-Spezifikation.
-
RequestIndex [in]
-
Definiert den 2-Byte-Sprach-ID-Code, der vom USBDevice beim Zurückgeben von Zeichenfolgendeskriptordaten verwendet wird. Der Parameter ist in der Regel 0 für Nicht-Zeichenfolgendeskriptoren. Weitere Informationen finden Sie in der USB-Spezifikation.
-
RequestLength [ein, aus]
-
Enthält bei der Eingabe die Länge (in Oktetten) des Deskriptors, der zurückgegeben werden soll. Wenn dieser Wert kleiner als die tatsächliche Länge des Deskriptors ist, wird nur die angeforderte Länge zurückgegeben. Wenn sie mehr als die tatsächliche Länge ist, wird die tatsächliche Länge zurückgegeben. Bei der Ausgabe ist dieser Parameter die Länge des zurückgegebenen Puffers in Oktetten. Wenn der angeforderte Deskriptor nicht vorhanden ist, ist der Inhalt dieses Parameters nicht definiert.
-
Puffer [out]
-
Gibt die angeforderten Deskriptorinformationen zurück. Wenn der Deskriptor nicht vorhanden ist, ist der Inhalt des Parameters undefiniert.
Rückgabewert
Gibt bei Erfolg eine 0 zurück. Gibt andernfalls einen Fehler zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 8.1 |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 R2 |
| Namespace |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|