WdfUsbTargetDeviceGetDeviceDescriptor-Funktion (wdfusb.h)
[Gilt für KMDF und UMDF]
Die WdfUsbTargetDeviceGetDeviceDescriptor-Methode ruft den USB-Gerätedeskriptor für das USB-Gerät ab, das einem angegebenen Framework-USB-Geräteobjekt zugeordnet ist.
Syntax
void WdfUsbTargetDeviceGetDeviceDescriptor(
[in] WDFUSBDEVICE UsbDevice,
[out] PUSB_DEVICE_DESCRIPTOR UsbDeviceDescriptor
);
Parameter
[in] UsbDevice
Ein Handle für ein USB-Geräteobjekt, das von einem vorherigen Aufruf von WdfUsbTargetDeviceCreateWithParameters abgerufen wurde.
[out] UsbDeviceDescriptor
Ein Zeiger auf eine vom Aufrufer zugewiesene USB_DEVICE_DESCRIPTOR Struktur, die den USB-Gerätedeskriptor empfängt.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn ein vom Treiber bereitgestelltes Objekthandle ungültig ist.
Weitere Informationen zur WdfUsbTargetDeviceGetDescriptor-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Im folgenden Codebeispiel wird der USB-Gerätedeskriptor für ein Gerät abgerufen. Im Beispiel wird der Deskriptor im vom Treiber definierten Kontextraum gespeichert.
PMY_DEVICE_CONTEXT myDeviceContext;
myDeviceContext = GetDeviceContext(device);
WdfUsbTargetDeviceGetDeviceDescriptor(
myDeviceContext->UsbTargetDevice,
&myDeviceContext->UsbDeviceDescr
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfusb.h (einschließlich Wdfusb.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |