Método IQueueCallbackIoStop::OnIoStop (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]
A função de retorno de chamada OnIoStop interrompe o processamento da solicitação de E/S especificada da fila especificada.
Sintaxe
void OnIoStop(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest,
[in] ULONG ActionFlags
);
Parâmetros
[in] pWdfQueue
Um ponteiro para a interface IWDFIoQueue para o objeto de fila de E/S do qual o processamento da solicitação de E/S é interrompido.
[in] pWdfRequest
Um ponteiro para a interface IWDFIoRequest que representa o objeto de solicitação de estrutura cujo processamento é interrompido.
[in] ActionFlags
Um OR bit a bit válido de valores digitados em WDF_REQUEST_STOP_ACTION_FLAGSque identifica o estado de uma solicitação de ação de parada.
Valor de retorno
Nenhum
Observações
Um driver registra a interface de IQueueCallbackIoStop quando o driver chama o método IWDFDevice::CreateIoQueue para criar uma fila de E/S ou configurar a fila de E/S padrão.
Se um driver registrar uma função de retorno de chamada OnIoStop para uma fila de E/S, a estrutura a chamará quando o dispositivo subjacente da fila estiver deixando seu estado de trabalho (D0). A estrutura chama a função de retorno de chamada OnIoStop para cada solicitação de E/S que o driver não concluiu, incluindo solicitações que o driver possui e aquelas que ele encaminhou para um destino de E/S.
A função de retorno de chamada OnIoStop deve ser concluída, cancelar ou adiar o processamento adicional da solicitação de E/S. Você deve usar as seguintes regras:
Se o driver possui a solicitação de E/S, ele deve chamar IWDFIoRequest::Complete para concluir ou cancelar a solicitação ou deve adiar o processamento adicional da solicitação e, em seguida, chamar IWDFIoRequest2::StopAcknowledge.
Se o driver encaminhou a solicitação de E/S para um destino de E/S, ele deve chamar IWDFIoRequest::CancelSentRequest para tentar cancelar a solicitação ou deve adiar o processamento adicional da solicitação e, em seguida, chamar StopAcknowledge.
Se o sinalizador WdfRequestStopRequestCancelable for definido no parâmetro ActionFlags, O driver deve chamar IWDFIoRequest::UnmarkCancelable antes de chamar IWDFIoRequest::Complete para concluir (ou cancelar) a solicitação ou chamar IWDFIoRequest2::StopAcknowledge para requeue a solicitação.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Windows |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |