IWDFUsbTargetDevice::RetrieveDeviceInformation-Methode (wudfusb.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die RetrieveDeviceInformation-Methode ruft Geräteinformationen des angegebenen Typs ab.

Syntax

HRESULT RetrieveDeviceInformation(
  [in]      ULONG InformationType,
  [in, out] ULONG *BufferLength,
  [out]     PVOID Buffer
);

Parameter

[in] InformationType

Der Typ der Informationen, die der UMDF-Treiber über das Gerät anfordert.

[in, out] BufferLength

Ein Zeiger auf eine Variable, die bei der Eingabe die Größe des Puffers in Bytes enthält, den RetrieveDeviceInformation in Buffer bereitstellt. In der Ausgabe enthält dieser Parameter die Größe, die RetrieveDeviceInformation für Buffer benötigt.

[out] Buffer

Ein Zeiger, der den Puffer empfängt, der die Geräteinformationen enthält.

Rückgabewert

RetrieveDeviceInformation gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	RetrieveDeviceInformation hat die Geräteinformationen erfolgreich abgerufen.
E_OUTOFMEMORY	RetrieveDeviceInformation ist ein Zuordnungsfehler aufgetreten.
Ein Fehlercode, der in Winerror.h definiert ist	Dieser Wert entspricht dem Fehlercode, den die WinUsb-API zurückgegeben hat.

Hinweise

Informationen zu gültigen Informationstypen, die ein UMDF-Treiber für den InformationType-Parameter übergeben kann, finden Sie in der funktion WinUsb_QueryDeviceInformation .

Wenn InformationType DEVICE_SPEED (0x01) ist, gibt Puffer bei erfolgreicher Rückgabe die Betriebsgeschwindigkeit des Geräts an. 0x03 gibt hochgeschwindigkeits oder höher an; 0x01 gibt die Volle Geschwindigkeit oder niedriger an.

Die RetrieveDeviceInformation-Methode generiert eine UMDF-Anforderung und sendet die Anforderung synchron an das E/A-Ziel.

Beispiele

Ein Codebeispiel für die Verwendung derRetrieveDeviceInformation-Methode finden Sie unter IWDFUsbTargetPipe::SetPipePolicy.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.5
Kopfzeile	wudfusb.h (einschließlich Wudfusb.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation