GetDescriptor-Methode der CIM_USBDevice-Klasse (Wmcodecdsp.h)

Die GetDescriptor-Methode gibt den USB-Gerätedeskriptor zurück, wie durch die Eingabeparameter angegeben.

Wichtig

Die CIM-Klassen (Common Information Model) von DMTF (Distributed Management Task Force) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.

In diesem Thema wird 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 den Empfänger. 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 niedrigen 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 mehr 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 wird, 1 (1), wenn die Anforderung nicht unterstützt wird, und eine andere Zahl, die auf einen Fehler hinweist. In einer Unterklasse kann der Satz möglicher Rückgabecodes mithilfe eines ValueMap-Qualifizierers für die -Methode angegeben werden. Die Zeichenfolgen, in die die Mofqualifiziererinhalte übersetzt werden, können auch in der Unterklasse als Wertearrayqualifizierer angegeben werden.

Bemerkungen

Diese Methode wird derzeit nicht von WMI implementiert. Um diese Methode verwenden zu können, müssen Sie sie in Ihrem eigenen Anbieter implementieren.

Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von der DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu korrigieren, den Microsoft SDK-Dokumentationsstandards zu entsprechen oder weitere Informationen bereitzustellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
Header	Wmcodecdsp.h
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

CIM_USBDevice

CIM_USBDevice