WdfDeviceGetIoTarget-Funktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WdfDeviceGetIoTarget--Methode gibt für ein angegebenes Gerät ein Handle an die lokalen E/A-Ziel-eines Funktions- oder Filtertreibers zurück.

Syntax

WDFIOTARGET WdfDeviceGetIoTarget(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt WdfDeviceGetIoTarget ein Handle an ein Framework-E/A-Zielobjekt zurück. Wenn das angegebene Framework-Geräteobjekt ein PDO darstellt, gibt die Methode NULL-zurück.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Wenn ein UMDF-Treiber eine vom Treiber erstellte Anforderung an ein lokales E/A-Ziel sendet, weist die Anforderung kein zugeordnetes Dateiobjekt auf. Einige niedrigere Ziele, z. B. eine HIDClass-enumerierte unformatierte PDO, schlagen Anforderungen fehl, die kein zugeordnetes Dateiobjekt aufweisen. In diesem Fall kann ein UMDF-Treiber WdfIoTargetOpenLocalTargetByFile- angeben, um ein E/A-Ziel zu erstellen, das den unteren Stapel (genau wie ein lokales Ziel) mit einem Dateihandle darstellt. Daher werden alle vom Treiber erstellten Anforderungen, die an dieses E/A-Ziel gesendet werden, dem Dateiobjekt zugeordnet, das dem geöffneten Handle entspricht.

Rufen Sie dazu die WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE-Funktion auf, bevor Sie WdfIoTargetOpenaufrufen.

Weitere Informationen zu E/A-Zielen finden Sie unter Using I/O Targets.

Beispiele

Im folgenden Codebeispiel wird ein Handle für das lokale E/A-Ziel eines bestimmten Geräts erhalten.

WDFIOTARGET  ioTargetHandle;

ioTargetHandle = WdfDeviceGetIoTarget(device);

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)