Freigeben über


GetDescriptor-Methode der CIM_USBHub-Klasse

Die GetDescriptor-Methode gibt den USB-Hubdeskriptor zurück, wie in den Eingabeparametern 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 [ein, aus]

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 undefiniert.

Puffer [out]

Puffer gibt die angeforderten Deskriptorinformationen zurück. Wenn der Deskriptor nicht vorhanden ist, ist der Inhalt des Puffers undefiniert.

Rückgabewert

Gibt den Wert 0 (null) zurück, wenn der USB-Deskriptor erfolgreich zurückgegeben wurde, 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 Mofqualifierinhalte übersetzt werden, können auch in der Unterklasse als Wertearrayqualifier 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 vom DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu beheben, den Dokumentationsstandards des Microsoft SDK 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_USBHub

CIM_USBHub