GetDescriptor-Methode der CIM_USBDevice-Klasse (Wmcodecdsp.h)
Die GetDescriptor-Methode gibt den USB-Gerätedeskriptor zurück, wie von den Eingabeparametern angegeben.
Wichtig
Die CIM-Klassen (Distributed Management Task Force) (DMTF (Distributed Management Task Force) (Common Information Model) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.
In diesem Thema wird die MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 GetDescriptor(
[in] uint8 RequestType,
[in] uint16 RequestValue,
[in] uint16 RequestIndex,
[in, out] uint16 RequestLength,
[out] uint8 Buffer[]
);
Parameter
-
RequestType [ In]
-
Bitzuordnungsbezeichner für den Typ der Deskriptoranforderung und des Empfängers. 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 Deskriptorarray) im unteren Byte. Weitere Informationen finden Sie in der USB-Spezifikation.
-
RequestIndex [ In]
-
Gibt den 2-Byte-Sprachbezeichnercode an, der vom USB-Gerät beim Zurückgeben von Zeichenfolgendeskriptordaten verwendet wird. Der Parameter ist in der Regel 0 (null) für Nichtzeichenfolgendeskriptoren. Weitere Informationen finden Sie in der USB-Spezifikation.
-
RequestLength [ in, out]
-
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 größer als die tatsächliche Länge ist, wird die tatsächliche Länge zurückgegeben.
Bei der Ausgabe die Länge (in Oktetten) des zurückgegebenen Puffers. 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 dieses Parameters nicht definiert.
Rückgabewert
Gibt den Wert 0 (null) zurück, wenn der USB-Deskriptor erfolgreich zurückgegeben wurde, 1 (eins), wenn die Anforderung nicht unterstützt wird, und eine beliebige andere Zahl, um einen Fehler anzugeben. In einer Unterklasse kann der Satz möglicher Rückgabecodes mithilfe eines ValueMap-Qualifizierers für die -Methode angegeben werden. Die Zeichenfolgen, in die der mofqualifier-Inhalt übersetzt wird, können auch in der Unterklasse als Values-Arrayqualifizierer angegeben werden.
Hinweise
Diese Methode wird derzeit nicht von WMI implementiert. Um diese Methode zu verwenden, müssen Sie sie in Ihrem eigenen Anbieter implementieren.
Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von dmtf veröffentlicht wurden. Möglicherweise hat Microsoft Änderungen vorgenommen, um kleinere Fehler zu korrigieren, den Dokumentationsstandards des Microsoft SDK zu entsprechen oder weitere Informationen bereitzustellen.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| Header |
|
| MOF |
|
| DLL |
|