Objeto de dispositivo framework

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.

O objeto de dispositivo de estrutura é exposto 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 driver pai.

Quando um novo dispositivo chega ao sistema, a estrutura chama o método IDriverEntry::OnDeviceAdd para notificar o driver da chegada e passa as 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. Em seguida, o driver pode chamar o método IWDFDriver::CreateDevice para configurar e criar o objeto do 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 PM (gerenciamento de energia). Para obter mais informações sobre como dar suporte a PnP e PM, consulte PnP e Gerenciamento de Energia em drivers baseados em UMDF.