Freigeben über


WdfDeviceGetIoTarget-Funktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WdfDeviceGetIoTarget-Methode gibt ein Handle für das lokale E/A-Ziel einer Funktion oder eines Filtertreibers für ein angegebenes Gerät zurück.

Syntax

WDFIOTARGET WdfDeviceGetIoTarget(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

Ein Handle für ein 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 Frameworkgerätobjekt eine PDO darstellt, gibt die Methode NULL zurück.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Wenn ein UMDF-Treiber eine vom Treiber erstellte Anforderung an ein lokales E/A-Ziel sendet, enthält die Anforderung kein zugeordnetes Dateiobjekt. Einige niedrigere Ziele, z. B. ein HIDClass-enumerated Raw PDO, schlagen Anforderungen fehl, die kein zugeordnetes Dateiobjekt aufweisen. In dieser Situation kann ein UMDF-Treiber WdfIoTargetOpenLocalTargetByFile angeben, um mithilfe eines Dateihandles ein E/A-Ziel zu erstellen, das den unteren Stapel (genau wie ein lokales Ziel) 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 hierzu die WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE-Funktion auf, bevor Sie WdfIoTargetOpen aufrufen.

Weitere Informationen zu E/A-Zielen finden Sie unter Verwenden von E/A-Zielen.

Beispiele

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

WDFIOTARGET  ioTargetHandle;

ioTargetHandle = WdfDeviceGetIoTarget(device);

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)