Método IWDFIoRequest::SetCompletionCallback (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso 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 com 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 cujo método OnCompletion 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 desregistrar 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.
Retornar valor
Nenhum
Comentários
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. |
| Plataforma de Destino | Área de Trabalho |
| Versão mínima do UMDF | 1.5 |
| Cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| DLL | WUDFx.dll |
Confira também
IRequestCallbackRequestCompletion