WdfIoTargetGetDevice-Funktion (wdfiotarget.h)

[Gilt für KMDF und UMDF]

Die WdfIoTargetGetDevice-Methode gibt ein Handle an das Framework-Geräteobjekt zurück, das das übergeordnete Element des angegebenen lokalen oder Remote-E/A-Ziels ist.

Syntax

WDFDEVICE WdfIoTargetGetDevice(
  [in] WDFIOTARGET IoTarget
);

Parameter

[in] IoTarget

Ein Handle für ein E/A-Zielobjekt. Dieses Handle wird von WdfDeviceGetIoTarget, WdfIoTargetCreate oder von einer Methode abgerufen, die ein spezialisiertes E/A-Ziel bereitstellt (z. B. WdfUsbTargetDeviceGetIoTarget).

Rückgabewert

WdfIoTargetGetDevice gibt ein Handle an ein Framework-Geräteobjekt zurück.

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

Hinweise

Weitere Informationen zu WdfIoTargetGetDevice finden Sie unter Abrufen von Informationen zu einem allgemeinen E/A-Ziel.

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

Beispiele

Das folgende Codebeispiel zeigt, wie eine EvtIoTargetQueryRemove-RückruffunktionWdfIoTargetGetDevice aufrufen kann.

NTSTATUS
MyEvtIoTargetQueryRemove(
    WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}

Anforderungen

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

Weitere Informationen

WdfDeviceGetIoTarget

WdfIoTargetCreate

WdfUsbTargetDeviceGetIoTarget