Criando objetos de retorno de chamada

Aviso

O 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 novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2.

Os exemplos umdf 1 arquivados podem ser encontrados no Windows 11, versão 22H2 – Atualização de exemplos de driver de maio de 2022.

Para obter mais informações, consulte Introdução com UMDF.

Um driver UMDF pode criar objetos de retorno de chamada, que consistem em dados de contexto e métodos de interface. A estrutura acessa os objetos de retorno de chamada do driver por meio dos métodos de interface de retorno de chamada do driver.

A figura a seguir mostra como os objetos de retorno de chamada implementados pelo driver correspondem aos objetos de estrutura.

Um driver UMDF pode criar vários tipos de objetos de retorno de chamada, incluindo o seguinte:

• Objeto de retorno de chamada do driver

  A estrutura usa o objeto de retorno de chamada do driver para inicializar o driver e notificar o driver sobre a chegada de um novo dispositivo.

• Objeto de retorno de chamada do dispositivo

  O driver usa o objeto de retorno de chamada do dispositivo para armazenar o contexto do dispositivo e lidar com a limpeza e o fechamento de objetos de arquivo e eventos de PnP (Plug and Play) e pm (gerenciamento de energia).

• Objeto de retorno de chamada de fila

  O driver usa o objeto de retorno de chamada de fila para processar E/S.

A figura a seguir mostra como um driver UMDF cria um objeto de retorno de chamada de dispositivo.

Os tópicos a seguir contêm exemplos de código que mostram como criar um objeto de retorno de chamada:

• Exemplo de criação de objetos de retorno de chamada

• Exemplo de definição de objetos de retorno de chamada

• Exemplo de associação de interfaces de retorno de chamada