EVT_WDF_IO_TARGET_REMOVE_COMPLETE Rückruffunktion (wdfiotarget.h)

[Gilt für KMDF und UMDF]

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

Syntax

EVT_WDF_IO_TARGET_REMOVE_COMPLETE EvtWdfIoTargetRemoveComplete;

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

Die Parameter

[in] IoTarget

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

Rückgabewert

Nichts

Bemerkungen

Wenn Sie eine EvtIoTargetRemoveComplete Rückruffunktion registrieren möchten, platzieren Sie die Adresse der Rückruffunktion in der WDF_IO_TARGET_OPEN_PARAMS Struktur der E/A-Zielfunktion.

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

Die EvtIoTargetRemoveComplete Rückruffunktion eines Treibers muss das Remote-E/A-Ziel dauerhaft schließen, indem WdfIoTargetCloseaufgerufen wird. Da das Zielgerät entfernt wurde, sollte die EvtIoTargetRemoveComplete Rückruffunktion auch alle zusätzlichen Zielentfernungsvorgänge ausführen, die erforderlich sein können, z. B. das Freigeben von Systemressourcen, die der Treiber beim Öffnen des Ziels zugewiesen haben könnte.

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

Weitere Informationen zur EvtIoTargetRemoveComplete Rückruffunktion finden Sie unter Controlling a General I/O Target's State.

Anforderungen

Siehe auch

EvtIoTargetQueryRemove

EvtIoTargetRemoveCanceled

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetClose