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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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
Nichts
Bemerkungen
Wenn sich ein Treiber für die Verwendung des AcquireLock Sperrschema konfiguriert hat, erhält das Framework automatisch die "Presentation"-Sperre, bevor er den Treiber aufruft. (Weitere Informationen zu diesem Sperrschema finden Sie unter Angeben eines Rückrufsynchronisierungsmodus.) Die AcquireLock und IWDFObject::ReleaseLock Methoden erwerben bzw. freigeben die Präsentationssperre. Framework-Geräteobjekte und Framework-E/A-Warteschlangenobjekte derzeit die AcquireLock-Methode unterstützen.
Der Treiber ruft die AcquireLock-Methode auf, um seine Objekte zu bearbeiten, die über die Rückrufschnittstellen außerhalb des Rückrufbereichs erstellt wurden, auf threadsichere Weise. Die AcquireLock-Methode stellt ein erweitertes Feature des Frameworks dar, das von den meisten Treibern nicht verwendet wird, da die fehlerhafte Verwendung zu Deadlocks führen kann.
Nicht synchronisierter Code kann AcquireLockaufrufen. Der Treiber sollte 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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |