EVT_WDF_IO_TARGET_REMOVE_COMPLETE Rückruffunktion (wdfiotarget.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die EvtIoTargetRemoveComplete-Ereignisrückruffunktion eines Treibers führt Vorgänge aus, wenn die Entfernung eines angegebenen Remote-E/A-Ziels abgeschlossen ist.

Syntax

EVT_WDF_IO_TARGET_REMOVE_COMPLETE EvtWdfIoTargetRemoveComplete;

void EvtWdfIoTargetRemoveComplete(
  [in] WDFIOTARGET IoTarget
)
{...}

Parameter

[in] IoTarget

Ein Handle für ein E/A-Zielobjekt.

Rückgabewert

Keine

Bemerkungen

Um eine EvtIoTargetRemoveComplete-Rückruffunktion zu registrieren, platzieren Sie die Adresse der Rückruffunktion in der WDF_IO_TARGET_OPEN_PARAMS Struktur des E/A-Ziels.

Das Framework ruft die EvtIoTargetRemoveComplete-Rückruffunktion Ihres Treibers auf, nachdem die EvtIoTargetQueryRemove-Rückruffunktion des Treibers STATUS_SUCCESS zurückgibt oder nachdem das Gerät unerwartet entfernt wurde (überraschend entfernt).

Die EvtIoTargetRemoveComplete-Rückruffunktion eines Treibers muss das Remote-E/A-Ziel dauerhaft schließen, indem WdfIoTargetClose aufgerufen wird. Da das Zielgerät entfernt wurde, sollte die Rückruffunktion EvtIoTargetRemoveComplete auch alle erforderlichen zusätzlichen Vorgänge zum Entfernen von Zielen ausführen, z. B. das Freigeben von Systemressourcen, die der Treiber beim Öffnen des Ziels möglicherweise zugewiesen hat.

Die Rückruffunktion EvtIoTargetRemoveComplete ist optional. Wenn der Treiber diese Rückruffunktion nicht zur Verfügung stellt, schließt das Framework das E/A-Ziel dauerhaft.

Weitere Informationen zur Rückruffunktion EvtIoTargetRemoveComplete finden Sie unter Steuern des Status eines allgemeinen E/A-Ziels.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfiotarget.h (einschließen von Wdf.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

EvtIoTargetQueryRemove

EvtIoTargetRemoveCanceled

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetClose