Método IImpersonateCallback::OnImpersonate (wudfddi.h)

  • Artigo

[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 OnImpersonate manipula a representação.

Sintaxe

void OnImpersonate(
  [in, optional] void *Context
);

Parâmetros

[in, optional] Context

Um ponteiro para um contexto que foi fornecido anteriormente no método IWDFIoRequest::Impersonate . Esse parâmetro é opcional e pode ser NULL se um contexto não for necessário.

Retornar valor

Nenhum

Comentários

Normalmente, o driver usa esse retorno de chamada para chamar uma função Win32 diretamente. Por exemplo, se o driver precisar abrir um arquivo de dados em nome de um aplicativo que enviou uma operação de E/S, o driver exigirá representação apenas para abrir o identificador de arquivo.

Para garantir que a representação não vaze entre funções de retorno de chamada do driver ou entre drivers de dispositivo, OnImpersonate não deve chamar nenhum método de estrutura.

Um driver registra a interface IImpersonateCallback quando o driver chama o método IWDFIoRequest::Impersonate .

Para obter mais informações sobre como os drivers UMDF e UMDF lidam com a representação, consulte Manipulando a representação.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho wudfddi.h (inclua Wudfddi.h)

Confira também

IImpersonateCallback

IWDFIoRequest::Impersonate