WdfObjectAcquireLock-Funktion (wdfsync.h)
[Gilt für KMDF und UMDF]
Die WdfObjectAcquireLock-Methode ruft die Synchronisierungssperre eines Objekts ab.
Syntax
VOID WdfObjectAcquireLock(
_In_ WDFOBJECT Object
);
Parameter
[in] Object
Ein Handle für ein Framework-Geräteobjekt oder ein Framework-Warteschlangenobjekt.
Hinweise
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Ein Treiber kann die WdfObjectAcquireLock-Methode aufrufen, um die Synchronisierungssperre abzurufen, die einem angegebenen Framework-Geräteobjekt oder framework-Warteschlangenobjekt zugeordnet ist. Die -Methode gibt erst zurück, wenn die Sperre abgerufen wurde.
Wenn der Treiber die Synchronisierungssperre des Objekts nicht mehr benötigt, muss er WdfObjectReleaseLock aufrufen.
Wenn der Treiber WdfExecutionLevelPassive für den ExecutionLevel-Member der WDF_OBJECT_ATTRIBUTES-Struktur des angegebenen Objekts angegeben hat, muss der Treiber WdfObjectAcquireLock unter IRQL <= APC_LEVEL aufrufen. WdfObjectAcquireLock ruft einen schnellen Mutex ab und gibt am IRQL des Aufrufers zurück. (In diesem Fall ruft WdfObjectAcquireLock vor der Rückgabe auch KeEnterCriticalRegion auf, sodass normale Kernel-APCs deaktiviert sind.)
Wenn der Treiber WdfExecutionLevelPassive für den ExecutionLevel-Member der WDF_OBJECT_ATTRIBUTES-Struktur des angegebenen Objekts nicht angegeben hat, muss der Treiber WdfObjectAcquireLock unter IRQL <= DISPATCH_LEVEL aufrufen. WdfObjectAcquireLock ruft eine Drehsperre ab und gibt bei IRQL = DISPATCH_LEVEL zurück.
Weitere Informationen zu Synchronisierungssperren finden Sie unter Synchronisierungstechniken für Framework-Based Treiber.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfsync.h (einschließen von Wdf.h) |
| IRQL | Weitere Informationen finden Sie im Abschnitt mit den Hinweisen. |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |