EVT_WDF_IO_TARGET_QUERY_REMOVE Rückruffunktion (wdfiotarget.h)

[Gilt für KMDF und UMDF]

Die EvtIoTargetQueryRemove-Ereignisrückruffunktion eines Treibers gibt an, ob das Framework das Gerät eines angegebenen Remote-E/A-Ziels sicher entfernen kann.

Syntax

EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;

NTSTATUS EvtWdfIoTargetQueryRemove(
  [in] WDFIOTARGET IoTarget
)
{...}

Parameter

[in] IoTarget

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

Rückgabewert

DieRückruffunktion EvtIoTargetQueryRemove muss STATUS_SUCCESS zurückgeben, wenn der Treiber feststellt, dass das Framework das Gerät des angegebenen E/A-Ziels sicher entfernen kann. Andernfalls muss diese Rückruffunktion STATUS_UNSUCCESSFUL zurückgeben.

Hinweise

Wenn die EvtIoTargetQueryRemove-Rückruffunktion eines Treibers STATUS_SUCCESS zurückgibt, ermöglicht das System das Entfernen des Geräts des E/A-Ziels, es sei denn, ein anderer Treiber gibt STATUS_UNSUCCESSFUL zurück.

Um eine EvtIoTargetQueryRemove-Rückruffunktion zu registrieren, platzieren Sie die Adresse der Rückruffunktion in der WDF_IO_TARGET_OPEN_PARAMS Struktur des E/A-Ziels. Die Rückruffunktion EvtIoTargetQueryRemove ist optional. Die Nichtbereitstellung dieser Rückruffunktion entspricht der Rückgabe STATUS_SUCCESS.

Die Rückruffunktion EvtIoTargetQueryRemove muss WdfIoTargetCloseForQueryRemove aufrufen, wenn der Treiber feststellt, dass der PnP-Manager das Zielgerät sicher entfernen kann.

Die Rückruffunktion muss die Fähigkeit des Treibers deaktivieren, zusätzliche E/A-Anforderungen an das E/A-Ziel zu senden.

Weitere Informationen zur Rückruffunktion EvtIoTargetQueryRemove 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

EvtIoTargetRemoveCanceled

EvtIoTargetRemoveComplete

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetCloseForQueryRemove