WdfDeviceGetIoTarget-Funktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die WdfDeviceGetIoTarget-Methode gibt einen Handle zu einem lokalen I/O-Ziel eines Funktions- oder Filtertreibers für ein angegebenes Gerät zurück.
Syntax
WDFIOTARGET WdfDeviceGetIoTarget(
[in] WDFDEVICE Device
);
Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt.
Rückgabewert
Wenn der Vorgang erfolgreich verläuft, gibt WdfDeviceGetIoTarget einen Handle an ein Framework-I/O-Zielobjekt zurück. Wenn das angegebene Framework-Geräteobjekt ein PDO darstellt, gibt die Methode NULL zurück.
Eine Fehlerprüfung tritt auf, wenn der Treiber einen ungültigen Objekthandpunkt bereitstellt.
Bemerkungen
Wenn ein UMDF-Treiber eine vom Treiber erstellte Anforderung an ein lokales I/O-Ziel sendet, weist die Anforderung kein zugeordnetes Dateiobjekt auf. Einige niedrigere Ziele, z. B. ein HIDClass-enumeriertes unformatiertes PDO, schlägt Anforderungen fehl, die kein zugeordnetes Dateiobjekt aufweisen. In dieser Situation kann ein UMDF-Treiber WdfIoTargetOpenLocalTargetByFile angeben, um ein I/O-Ziel zu erstellen, das den unteren Stapel (genau wie ein lokales Ziel) mit einem Dateihandpunkt darstellt. Daher werden alle an dieses I/O-Ziel gesendeten Treiberanforderungen 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 WdfIoTargetOpen aufrufen.
Weitere Informationen zu I/O-Zielen finden Sie unter Verwenden von I/O-Zielen.
Beispiele
Im folgenden Codebeispiel wird ein Handle auf das lokale I/O-Ziel eines bestimmten Geräts zurückgegeben.
WDFIOTARGET ioTargetHandle;
ioTargetHandle = WdfDeviceGetIoTarget(device);
Anforderungen
Zielplattform | Universell |
KMDF-Mindestversion | 1.0 |
UMDF-Mindestversion | 2.0 |
Header | wdfdevice.h (enthalten Wdf.h) |
Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | <= DISPATCH_LEVEL |
DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |