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 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) |