Partilhar via


Adicionar um dispositivo

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.

A estrutura adiciona um objeto de dispositivo para cada dispositivo carregado no processo de host do driver. Para adicionar o dispositivo, a estrutura chama o método IDriverEntry::OnDeviceAdd do driver e passa as interfaces IWDFDriver e IWDFDeviceInitialize na chamada. A interface IWDFDeviceInitialize fornecida só é válida antes que o driver chame IWDFDriver::CreateDevice. O driver pode chamar os seguintes métodos de IWDFDeviceInitialize para executar as seguintes operações:

Depois que o driver usa IWDFDeviceInitialize para inicializar o dispositivo, o driver passa um ponteiro para IWDFDeviceInitialize em uma chamada para o método IWDFDriver::CreateDevice para criar um objeto de dispositivo UMDF para o dispositivo. Depois que o objeto de dispositivo de estrutura é criado, o driver faz chamadas para o método IWDFDevice::CreateIoQueue para criar filas de E/S de leitura e gravação. Nessas chamadas IWDFDevice::CreateIoQueue , o driver deve identificar como recebe solicitações da fila de E/S. Para obter mais informações, consulte Configuração do modo de despacho para uma fila de E/S.