Método IImpersonateCallback::OnImpersonate (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 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) |