WdfObjectAcquireLock-Funktion (wdfsync.h)

  • Artikel

[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)

Weitere Informationen

WDF_OBJECT_ATTRIBUTES

KeEnterCriticalRegion

WdfObjectReleaseLock