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)

Weitere Informationen

WDF_IO_TARGET_STATE

WdfDeviceGetIoTarget

WdfIoTargetCreate