Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt nur für KMDF]
Die WdfUsbTargetDeviceWdmGetConfigurationHandle--Methode gibt den USBD_CONFIGURATION_HANDLE typisierten Handle zurück, der 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 WdfUsbTargetDeviceCreateWithParametersabgerufen wurde.
Rückgabewert
Wenn der Treiber eine Konfiguration für das Gerät ausgewählt hat, gibt WdfUsbTargetDeviceWdmGetConfigurationHandle das USBD_CONFIGURATION_HANDLE Typ-Handle des Geräts zurück. Andernfalls gibt die Methode NULL-zurück.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Ein frameworkbasierter Treiber muss nur dann ein USBD_CONFIGURATION_HANDLE typisiertes Handle abrufen, wenn ein URB- erstellt wird, das eine _URB_SELECT_INTERFACE Struktur enthält.
Der Treiber kann WdfUsbTargetDeviceWdmGetConfigurationHandle aufrufen, nachdem er WdfUsbTargetDeviceSelectConfigaufgerufen hat. Das USBD_CONFIGURATION_HANDLE-Typ-Handle, das WdfUsbTargetDeviceWdmGetConfigurationHandle zurückgegeben wird, 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ückgegeben wird.
Weitere Informationen zu den 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 erhalten.
USBD_CONFIGURATION_HANDLE deviceConfigHdl;
deviceConfigHdl = WdfUsbTargetDeviceWdmGetConfigurationHandle(UsbDevice);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Header- | wdfusb.h (include Wdfusb.h) |
| Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |