Partilhar via


Objeto de dispositivo do Framework

Advertência

UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser escritos 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 UMDF 2.

Os exemplos de UMDF 1 arquivados podem ser encontrados na Windows 11, versão 22H2 - Atualização de Amostras de Driver de maio de 2022.

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

O objeto de dispositivo de framework é disponibilizado aos drivers pela interface IWDFDevice. O objeto de dispositivo de estrutura é a representação de estrutura do dispositivo no sistema. Cada objeto de dispositivo tem um objeto de controlador pai.

Quando um novo dispositivo chega ao sistema, a estrutura chama o método IDriverEntry::OnDeviceAdd para notificar o driver da chegada e passa pelas interfaces IWDFDriver e IWDFDeviceInitialize na chamada. O driver pode chamar métodos da interface IWDFDeviceInitialize para inicializar o novo dispositivo. Por exemplo, o driver chama o método IWDFDeviceInitialize::RetrieveDevicePropertyStore para consultar as informações do dispositivo fornecidas como parte da instalação do dispositivo. O driver pode então chamar o método IWDFDriver::CreateDevice para configurar e criar o objeto de dispositivo.

Quando os drivers criam um objeto de dispositivo de estrutura, eles podem registrar suas interfaces IPnpCallback, IPnpCallbackSelfManagedIo, IPnpCallbackHardware, IFileCallbackCleanup e IFileCallbackClose . Em seguida, a estrutura notifica o driver quando ocorrem eventos de limpeza e fechamento de arquivos e Plug and Play (PnP) e gerenciamento de energia (PM). Para obter mais informações sobre como oferecer suporte a PnP e PM, consulte PnP e gerenciamento de energia em drivers baseados em UMDF.