Método IQueueCallbackIoStop::OnIoStop (wudfddi.h)

Artículo
03/05/2024

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

La función de devolución de llamada OnIoStop detiene el procesamiento de la solicitud de E/S especificada de la cola especificada.

Sintaxis

void OnIoStop(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] ULONG         ActionFlags
);

Parámetros

[in] pWdfQueue

Puntero a la interfaz IWDFIoQueue del objeto de cola de E/S desde el que se detiene el procesamiento de la solicitud de E/S.

[in] pWdfRequest

Puntero a la interfaz IWDFIoRequest que representa el objeto de solicitud de marco cuyo procesamiento se detiene.

[in] ActionFlags

OR bit a bit válido de valores con tipo WDF_REQUEST_STOP_ACTION_FLAGS que identifica el estado de una solicitud de acción de detención.

Valor devuelto

None

Observaciones

Un controlador registra la interfaz IQueueCallbackIoStop cuando el controlador llama al método IWDFDevice::CreateIoQueue para crear una cola de E/S o para configurar la cola de E/S predeterminada.

Si un controlador registra una función de devolución de llamada OnIoStop para una cola de E/S, el marco lo llama cuando el dispositivo subyacente de la cola deja su estado de trabajo (D0). El marco llama a la función de devolución de llamada OnIoStop para cada solicitud de E/S que el controlador no ha completado, incluidas las solicitudes que posee el controlador y las que ha reenviado a un destino de E/S.

La función de devolución de llamada OnIoStop debe completar, cancelar o posponer el procesamiento posterior de la solicitud de E/S. Debe usar las siguientes reglas:

Si el controlador posee la solicitud de E/S, debe llamar a IWDFIoRequest::Complete para completar o cancelar la solicitud, o debe posponer el procesamiento posterior de la solicitud y, a continuación, llamar a IWDFIoRequest2::StopAcknowledge.

Si el controlador ha reenviado la solicitud de E/S a un destino de E/S, debe llamar a IWDFIoRequest::CancelSentRequest para intentar cancelar la solicitud, o bien debe posponer el procesamiento posterior de la solicitud y, a continuación, llamar a StopAcknowledge.

Si la marca WdfRequestStopRequestCancelable está establecida en el parámetro ActionFlags , el controlador debe llamar a IWDFIoRequest::UnmarkCancelable antes de llamar a IWDFIoRequest::Complete para completar (o cancelar) la solicitud o llamar a IWDFIoRequest2::StopAcknowledge para volver a poner en cola la solicitud.