WdfUsbTargetDeviceWdmGetConfigurationHandle-Funktion (wdfusb.h)
[Gilt nur für KMDF]
Die WdfUsbTargetDeviceWdmGetConfigurationHandle-Methode gibt das USBD_CONFIGURATION_HANDLE typisierte Handle zurück, das der aktuellen Konfiguration eines angegebenen USB-Geräts zugeordnet ist.
Syntax
USBD_CONFIGURATION_HANDLE WdfUsbTargetDeviceWdmGetConfigurationHandle(
[in] WDFUSBDEVICE UsbDevice
);
Parameter
[in] UsbDevice
Ein Handle für ein USB-Geräteobjekt, das aus einem vorherigen Aufruf von WdfUsbTargetDeviceCreateWithParameters abgerufen wurde.
Rückgabewert
Wenn der Treiber eine Konfiguration für das Gerät ausgewählt hat, gibt WdfUsbTargetDeviceWdmGetConfigurationHandle das USBD_CONFIGURATION_HANDLE typisierte Handle des Geräts zurück. Andernfalls gibt die Methode NULL zurück.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Ein frameworkbasierter Treiber muss nur dann ein USBD_CONFIGURATION_HANDLE typisiertes Handle abrufen, wenn er eine URB erstellt, die eine _URB_SELECT_INTERFACE-Struktur enthält.
Der Treiber kann WdfUsbTargetDeviceWdmGetConfigurationHandle aufrufen, nachdem er WdfUsbTargetDeviceSelectConfig aufgerufen hat. Das USBD_CONFIGURATION_HANDLE typisierte Handle, das WdfUsbTargetDeviceWdmGetConfigurationHandle zurückgibt, ist gültig, bis der Treiber WdfUsbTargetDeviceSelectConfig erneut aufruft oder das USB-Geräteobjekt gelöscht wird. Wenn der Treiber eine EvtCleanupCallback-Funktion für das USB-Geräteobjekt bereitstellt und das Objekt gelöscht wird, bevor der Treiber WdfUsbTargetDeviceSelectConfig erneut aufruft, ist das Handle gültig, bis die EvtCleanupCallback-Funktion des Objekts zurückgibt.
Weitere Informationen zur WdfUsbTargetDeviceWdmGetConfigurationHandle-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Im folgenden Codebeispiel wird ein Handle für die aktuelle Konfiguration eines angegebenen USB-Geräts abgerufen.
USBD_CONFIGURATION_HANDLE deviceConfigHdl;
deviceConfigHdl = WdfUsbTargetDeviceWdmGetConfigurationHandle(UsbDevice);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfusb.h (wdfusb.h einschließen) |
| Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |