Método IWDFObject::AcquireLock (wudfddi.h)

  • Artículo

[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

Consulte también

IWDFObject

IWDFObject::ReleaseLock