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 evento EvtIoTargetQueryRemove de un controlador indica si el marco puede quitar de forma segura el dispositivo del 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

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

Comentarios

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

Para registrar una función de devolución de llamada EvtIoTargetQueryRemove , coloque la dirección de la función de devolución de llamada en la estructura de WDF_IO_TARGET_OPEN_PARAMS del 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.

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

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 EvtIoTargetQueryRemove , vea Controlar el estado de un destino de E/S general.

Requisitos

Requisito Value
Plataforma de destino 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