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 |