WdfIoTargetGetState-Funktion (wdfiotarget.h)
[Gilt für KMDF und UMDF]
Die WdfIoTargetGetState-Methode gibt Zustandsinformationen für ein lokales oder Remote-E/A-Ziel zurück.
Syntax
WDF_IO_TARGET_STATE WdfIoTargetGetState(
[in] WDFIOTARGET IoTarget
);
Parameter
[in] IoTarget
Ein Handle für ein lokales oder Remote-E/A-Zielobjekt, das aus einem vorherigen Aufruf von WdfDeviceGetIoTarget oder WdfIoTargetCreate oder von einer Methode abgerufen wurde, die von einem spezialisierten E/A-Ziel bereitgestellt wird.
Rückgabewert
WdfIoTargetGetState gibt einen WDF_IO_TARGET_STATE typisierten Wert zurück, der den Status des angegebenen E/A-Ziels angibt.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Weitere Informationen zu WdfIoTargetGetState finden Sie unter Steuern des Status eines allgemeinen E/A-Ziels.
Weitere Informationen zu E/A-Zielen finden Sie unter Verwenden von E/A-Zielen.
Beispiele
Im folgenden Codebeispiel werden Zustandsinformationen für ein USB-E/A-Ziel abgerufen.
WDF_IO_TARGET_STATE ioTargetState;
ioTargetState = WdfIoTargetGetState(WdfUsbTargetPipeGetIoTarget(pipeHandle));
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfiotarget.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |