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 |
|---|---|
|
RetrieveDeviceInformation hat die Geräteinformationen erfolgreich abgerufen. |
|
RetrieveDeviceInformation ist ein Zuordnungsfehler aufgetreten. |
|
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 |