Método IWDFObject::AcquireLock (wudfddi.h)
[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. Para obtener más información, consulta Introducción con UMDF.
El método AcquireLock impide que el marco llame a métodos de interfaces que registró un controlador.
Sintaxis
void AcquireLock();
Valor devuelto
None
Observaciones
Si un controlador se configuró para usar el esquema de bloqueo AcquireLock , el marco adquiere automáticamente el bloqueo de "presentación" antes de llamar al controlador. (Para obtener más información sobre este esquema de bloqueo, vea Especificar un modo de sincronización de devolución de llamada). Los métodos AcquireLock e IWDFObject::ReleaseLock adquieren y liberan el bloqueo de presentación, respectivamente. Los objetos de dispositivo de marco y los objetos de cola de E/S de marco admiten actualmente el método AcquireLock .
El controlador llama al método AcquireLock para manipular sus objetos creados a partir de sus interfaces de devolución de llamada fuera del ámbito de devolución de llamada de una manera segura para subprocesos. El método AcquireLock representa una característica avanzada del marco que la mayoría de los controladores no usarán porque el uso incorrecto puede dar lugar a interbloqueos.
El código sin sincronizar puede llamar a AcquireLock. El controlador debe llamar a en objetos que coincidan con su ámbito de sincronización.
Ejemplos
Para obtener un ejemplo de código sobre cómo usar el método AcquireLock , vea IWDFDevice::SetPnpState.
Requisitos
| Requisito | Value |
|---|---|
| Finalización del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Versión mínima de UMDF | 1.5 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |