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 |