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