EVT_WDF_IO_TARGET_QUERY_REMOVE funzione di callback (wdfiotarget.h)

  • Articolo

[Si applica a KMDF e UMDF]

La funzione di callback dell'evento EvtIoTargetQueryRemove di un driver 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

La funzione di callbackEvtIoTargetQueryRemove 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.

Commenti

Se la funzione di callback EvtIoTargetQueryRemove di un driver restituisce STATUS_SUCCESS, il sistema consente la rimozione del dispositivo della destinazione di I/O, a meno che un altro driver non restituisca STATUS_UNSUCCESSFUL.

Per registrare una funzione di callback EvtIoTargetQueryRemove , inserire l'indirizzo della funzione di callback nella struttura di WDF_IO_TARGET_OPEN_PARAMS della destinazione I/O. La funzione di callback EvtIoTargetQueryRemove è facoltativa. La mancata fornitura di questa funzione di callback equivale a restituire STATUS_SUCCESS.

La funzione di callback EvtIoTargetQueryRemove 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 Controlling a General I/O Target's State.For more information about the EvtIoTargetQueryRemove callback function, see Controlling a General I/O Target's State.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfiotarget.h (include Wdf.h)
IRQL PASSIVE_LEVEL

Vedi anche

EvtIoTargetRemoveCanceled

EvtIoTargetRemoveComplete

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetCloseForQueryRemove