Metodo IWDFObject::AcquireLock (wudfddi.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]

Il metodo AcquireLock impedisce al framework di chiamare metodi di interfacce registrati da un driver.

Sintassi

void AcquireLock();

Valore restituito

nessuno

Osservazioni

Se un driver si è configurato per usare lo schema di blocco AcquireLock , il framework acquisisce automaticamente il blocco "presentazione" prima di chiamare il driver. Per altre informazioni su questo schema di blocco, vedere Specifica di una modalità di sincronizzazione del callback. I metodi AcquireLock e IWDFObject::ReleaseLock acquisiscono e rilasciano rispettivamente il blocco della presentazione. Gli oggetti dispositivo framework e gli oggetti coda I/O del framework supportano attualmente il metodo AcquireLock .

Il driver chiama il metodo AcquireLock per modificare i relativi oggetti creati dalle relative interfacce di callback all'esterno dell'ambito di callback in modo thread-safe. Il metodo AcquireLock rappresenta una funzionalità avanzata del framework che la maggior parte dei driver non userà perché l'utilizzo non corretto può causare deadlock.

Il codice non sincronizzato può chiamare AcquireLock. Il driver deve chiamare sugli oggetti che corrispondono al relativo ambito di sincronizzazione.

Esempio

Per un esempio di codice di come usare il metodo AcquireLock , vedere IWDFDevice::SetPnpState.

Requisiti

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione	Desktop
Versione UMDF minima	1.5
Intestazione	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Vedi anche

IWDFObject

IWDFObject::ReleaseLock