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

Confira também

IRequestCallbackRequestCompletion

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest

IWDFIoRequest::Send