Compartir a través de


EVT_WDF_IO_TARGET_QUERY_REMOVE función de devolución de llamada (wdfiotarget.h)

[Se aplica a KMDF y UMDF]

La función de devolución de llamada de eventos EvtIoTargetQueryRemove de un controlador indica si el marco puede quitar de forma segura un dispositivo de destino de E/S remoto especificado.

Sintaxis

EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;

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

Parámetros

[in] IoTarget

Identificador de un objeto de destino de E/S.

Valor devuelto

ElEvtIoTargetQueryRemove función de devolución de llamada debe devolver STATUS_SUCCESS si el controlador determina que el marco puede quitar de forma segura el dispositivo de destino de E/S especificado. De lo contrario, esta función de devolución de llamada debe devolver STATUS_UNSUCCESSFUL.

Observaciones

Si el evtIoTargetQueryRemove de un controlador función de devolución de llamada devuelve STATUS_SUCCESS, el sistema permite quitar el dispositivo del destino de E/S, a menos que otro controlador devuelva STATUS_UNSUCCESSFUL.

Para registrar un EvtIoTargetQueryRemove función de devolución de llamada, coloque la dirección de la función de devolución de llamada en la estructura de WDF_IO_TARGET_OPEN_PARAMS de destino de E/S. La función de devolución de llamada EvtIoTargetQueryRemove es opcional. No proporcionar esta función de devolución de llamada equivale a devolver STATUS_SUCCESS.

El EvtIoTargetQueryRemove función de devolución de llamada debe llamar a WdfIoTargetCloseForQueryRemove, si el controlador determina que el administrador de PnP puede quitar de forma segura el dispositivo de destino.

La función de devolución de llamada debe deshabilitar la capacidad del controlador para enviar solicitudes de E/S adicionales al destino de E/S.

Para obtener más información sobre la función de devolución de llamada de EvtIoTargetQueryRemo ve, consulte Controlar el estado de un destino de E/S general.

Requisitos

Requisito Valor
de la plataforma de destino de Universal
versión mínima de KMDF 1.0
versión mínima de UMDF 2.0
encabezado wdfiotarget.h (incluya Wdf.h)
irQL PASSIVE_LEVEL

Consulte también

EvtIoTargetRemoveCanceled

EvtIoTargetRemoveComplete

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetCloseForQueryRemove