Especificar un modo de sincronización de devolución de llamada

Advertencia

UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2.

Los ejemplos de UMDF 1 archivados se pueden encontrar en la actualización de ejemplos de controladores de Windows 11, versión 22H2 - mayo de 2022.

Para obtener más información, consulta Introducción con UMDF.

El controlador puede especificar cómo el marco llama a sus funciones de devolución de llamada. El controlador especifica un modo de sincronización (o bloqueo) para un dispositivo antes de llamar al método IWDFDriver::CreateDevice para crear un objeto de dispositivo para el dispositivo. Para especificar el modo de sincronización, el controlador debe llamar al método IWDFDeviceInitialize::SetLockingConstraint . El controlador recibe un puntero a la interfaz IWDFDeviceInitialize cuando se llama a su método IDriverEntry::OnDeviceAdd para agregar el dispositivo al sistema.

El controlador puede especificar uno de los siguientes valores del tipo de enumeración WDF_CALLBACK_CONSTRAINT en el parámetro LockType de IWDFDeviceInitialize::SetLockingConstraint para identificar el modo de bloqueo. El tipo de restricción (o bloqueo) especificado depende de cuánto paralelismo puede aprovechar el dispositivo de hardware y cuánto puede controlar el controlador.

Valor	Significado
Ninguno (0)	Indica que no se sincronizan funciones de devolución de llamada en el controlador.
WdfDeviceLevel (1)	Indica que se sincronizan todas las funciones de devolución de llamada de cola en el controlador.

Nota Si el controlador no llama a IWDFDeviceInitialize::SetLockingConstraint para especificar un valor, el marco establece el valor predeterminado de esta propiedad en WdfDeviceLevel.

Las restricciones solo se aplican a las funciones de devolución de llamada de cola y no a Plug and Play (PnP) y a las funciones de devolución de llamada de administración de energía. Las funciones de devolución de llamada de cola incluyen lo siguiente:

• Funciones de devolución de llamada de envío automáticas, como IQueueCallbackRead::OnRead e IQueueCallbackWrite::OnWrite. Para obtener más información, consulte Funciones de devolución de llamada de eventos de cola de E /S.

• Funciones de devolución de llamada de cambio de estado de cola, como IQueueCallbackStateChange::OnStateChange.

• Funciones de devolución de llamada de cancelación de solicitudes, como IRequestCallbackCancel::OnCancel.

• Limpieza de archivos y cierre las funciones de devolución de llamada, como IFileCallbackCleanup::OnCleanupFile e IFileCallbackClose::OnCloseFile.

Las funciones de devolución de llamada de finalización de solicitudes (IRequestCallbackRequestCompletion::OnCompletion) no son funciones de devolución de llamada en cola. Por lo tanto, no se sincronizan.