IWDFObject::AcquireLock-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die AcquireLock-Methode verhindert, dass das Framework Methoden von Schnittstellen aufruft, die ein Treiber registriert hat.

Syntax

void AcquireLock();

Rückgabewert

Keine

Bemerkungen

Wenn sich ein Treiber für die Verwendung des AcquireLock-Sperrschemas konfiguriert hat, ruft das Framework automatisch die Präsentationssperre ab, bevor es den Treiber aufruft. (Weitere Informationen zu diesem Sperrschema finden Sie unter Angeben eines Rückrufsynchronisierungsmodus.) Mit den Methoden AcquireLock und IWDFObject::ReleaseLock wird die Präsentationssperre abgerufen bzw. freigegeben. Frameworkgeräteobjekte und Framework-E/A-Warteschlangenobjekte unterstützen derzeit die AcquireLock-Methode .

Der Treiber ruft die AcquireLock-Methode auf, um seine Objekte, die über seine Rückrufschnittstellen außerhalb des Rückrufbereichs erstellt wurden, threadsicher zu bearbeiten. Die AcquireLock-Methode stellt ein erweitertes Feature des Frameworks dar, das von den meisten Treibern nicht verwendet wird, da eine unsachgemäße Verwendung zu Deadlocks führen kann.

Nicht synchronisierter Code kann AcquireLock aufrufen. Der Treiber sollte für Objekte aufrufen, die dem Synchronisierungsbereich entsprechen.

Beispiele

Ein Codebeispiel für die Verwendung der AcquireLock-Methode finden Sie unter IWDFDevice::SetPnpState.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.5
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFObject

IWDFObject::ReleaseLock