Especificando um modo de sincronização 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.

O driver pode especificar como suas funções de retorno de chamada são chamadas pela estrutura. O driver especifica um modo de sincronização (ou bloqueio) para um dispositivo antes de chamar o método IWDFDriver::CreateDevice para criar um objeto de dispositivo para o dispositivo. Para especificar o modo de sincronização, o driver deve chamar o método IWDFDeviceInitialize::SetLockingConstraint . O driver recebe um ponteiro para a interface IWDFDeviceInitialize quando seu método IDriverEntry::OnDeviceAdd é chamado para adicionar o dispositivo ao sistema.

O driver pode especificar um dos seguintes valores do tipo de enumeração WDF_CALLBACK_CONSTRAINT no parâmetro LockType de IWDFDeviceInitialize::SetLockingConstraint para identificar o modo de bloqueio. O tipo de restrição (ou bloqueio) especificado depende da quantidade de paralelismo que o dispositivo de hardware pode explorar e o quanto o driver pode lidar.

Valor	Significado
Nenhum (0)	Indica que nenhuma função de retorno de chamada no driver é sincronizada.
WdfDeviceLevel (1)	Indica que todas as funções de retorno de chamada de fila no driver são sincronizadas.

Nota Se o driver não chamar IWDFDeviceInitialize::SetLockingConstraint para especificar um valor, a estrutura definirá o valor padrão dessa propriedade como WdfDeviceLevel.

As restrições se aplicam apenas a funções de retorno de chamada de fila e não a funções de retorno de chamada de Plug and Play (PnP) e de gerenciamento de energia. As funções de retorno de chamada de fila incluem o seguinte:

• Funções de retorno de chamada de expedição automática, como IQueueCallbackRead::OnRead e IQueueCallbackWrite::OnWrite. Para obter mais informações, consulte Funções de retorno de chamada de evento de fila de E/S.

• Funções de retorno de chamada de alteração de estado da fila, como IQueueCallbackStateChange::OnStateChange.

• Solicitar funções de retorno de chamada de cancelamento, como IRequestCallbackCancel::OnCancel.

• Limpeza de arquivo e fechar funções de retorno de chamada, como IFileCallbackCleanup::OnCleanupFile e IFileCallbackClose::OnCloseFile.

As funções de retorno de chamada de conclusão de solicitação (IRequestCallbackRequestCompletion::OnCompletion) não são funções de retorno de chamada de fila. Portanto, eles não são sincronizados.