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.
WDFDEVICE WdfIoTargetGetDevice(
[in] WDFIOTARGET IoTarget
);
[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).
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.
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.
Das folgende Codebeispiel zeigt, wie eine EvtIoTargetQueryRemove-RückruffunktionWdfIoTargetGetDevice aufrufen kann.
NTSTATUS
MyEvtIoTargetQueryRemove(
WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}
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) |