Método IWDFIoRequest::SetCompletionCallback (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 .]
O método SetCompletionCallback registra a interface do método OnCompletion que a estrutura deve chamar quando uma solicitação de E/S é concluída.
Sintaxe
void SetCompletionCallback(
[in] IRequestCallbackRequestCompletion *pCompletionCallback,
[in, optional] void *pContext
);
Parâmetros
[in] pCompletionCallback
Um ponteiro para a interface IRequestCallbackRequestCompletion cuja OnCompletion método que a estrutura chama após a conclusão da solicitação de E/S. A partir da versão 1.9 do UMDF, o driver pode especificar NULL para cancelar o registro de um método OnCompletion registrado anteriormente.
[in, optional] pContext
Um ponteiro para um buffer que contém informações de contexto relacionadas à conclusão da solicitação. A estrutura passa essas informações de contexto em uma chamada para o método IRequestCallbackRequestCompletion::OnCompletion. Esse parâmetro é opcional e pode ser NULL.
Valor de retorno
Nenhum
Observações
Se um driver que encaminha uma solicitação de E/S exigir notificação quando o driver de nível inferior concluir a solicitação, o driver poderá fornecer uma rotina de conclusão e chamar SetCompletionCallback para registrar a interface IRequestCallbackRequestCompletion para a rotina de conclusão. A estrutura chama a rotina de conclusão depois que o driver de nível inferior conclui a solicitação de E/S.
Exemplos
Para obter um exemplo de código de como usar o método SetCompletionCallback, consulte IWDFIoRequest::Send.
Requisitos
| Requisito | Valor |
|---|---|
| fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.5 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| de DLL | WUDFx.dll |
Consulte também
IRequestCallbackRequestCompletion