EVT_WDF_IO_TARGET_QUERY_REMOVE funzione di callback (wdfiotarget.h)
[Si applica a KMDF e UMDF]
La funzione di callback di un driver EvtIoTargetQueryRemove indica se il framework può rimuovere in modo sicuro un dispositivo di destinazione di I/O remoto specificato.
Sintassi
EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;
NTSTATUS EvtWdfIoTargetQueryRemove(
[in] WDFIOTARGET IoTarget
)
{...}
Parametri
[in] IoTarget
Handle per un oggetto di destinazione di I/O.
Valore restituito
IlEvtIoTargetQueryRemove funzione di callback deve restituire STATUS_SUCCESS se il driver determina che il framework può rimuovere in modo sicuro il dispositivo di destinazione di I/O specificato. In caso contrario, questa funzione di callback deve restituire STATUS_UNSUCCESSFUL.
Osservazioni:
Se la funzione di callback di un driver EvtIoTargetQueryRemove restituisce STATUS_SUCCESS, il sistema consente la rimozione del dispositivo di destinazione I/O, a meno che un altro driver non restituisca STATUS_UNSUCCESSFUL.
Per registrare un EvtIoTargetQueryRemove funzione di callback, posizionare l'indirizzo della funzione di callback nella struttura di WDF_IO_TARGET_OPEN_PARAMS della destinazione I/O. La EvtIoTargetQueryRemove funzione di callback è facoltativa. La mancata fornitura di questa funzione di callback equivale a restituire STATUS_SUCCESS.
Il EvtIoTargetQueryRemove funzione di callback deve chiamare WdfIoTargetCloseForQueryRemove, se il driver determina che il gestore PnP può rimuovere in modo sicuro il dispositivo di destinazione.
La funzione di callback deve disabilitare la capacità del driver di inviare richieste di I/O aggiuntive alla destinazione di I/O.
Per altre informazioni sulla funzione di callback EvtIoTargetQueryRemove, vedere Controllo dello stato di una destinazione I/O generale.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | wdfiotarget.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |