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)

Weitere Informationen

URB

WdfUsbTargetDeviceSelectConfig

_URB_SELECT_INTERFACE