WdfObjectAcquireLock-Funktion (wdfsync.h)
[Gilt für KMDF und UMDF]
Die WdfObjectAcquireLock- Methode erwirbt die Synchronisierungssperre eines Objekts.
Syntax
VOID WdfObjectAcquireLock(
_In_ WDFOBJECT Object
);
Parameter
[in] Object
Ein Handle für ein Framework-Geräteobjekt oder ein Framework-Warteschlangenobjekt.
Rückgabewert
Nichts
Bemerkungen
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Ein Treiber kann die WdfObjectAcquireLock- Methode aufrufen, um die Synchronisierungssperre abzurufen, die einem angegebenen Framework-Geräteobjekt oder Framework-Warteschlangenobjekt zugeordnet ist. Die Methode wird erst zurückgegeben, wenn die Sperre abgerufen wurde.
Wenn der Treiber die Synchronisierungssperre des Objekts nicht mehr benötigt, muss er WdfObjectReleaseLockaufrufen.
Wenn der angegebene Treiber WdfExecutionLevelPassive für das ExecutionLevel Element der WDF_OBJECT_ATTRIBUTES Struktur des angegebenen Objekts angegeben hat, muss der Treiber WdfObjectAcquireLock- bei IRQL <= APC_LEVEL aufrufen. WdfObjectAcquireLock eine schnelle Mutex- abruft und an der IRQL des Aufrufers zurückgibt. (In diesem Fall ruft WdfObjectAcquireLock auch KeEnterCriticalRegion auf, damit normalen Kernel-APCs deaktiviert sind.)
Wenn der Treiber nichtWdfExecutionLevelPassive für das ExecutionLevel Member der WDF_OBJECT_ATTRIBUTES Struktur des angegebenen Objekts angegeben hat, muss der Treiber WdfObjectAcquireLock bei IRQL <= DISPATCH_LEVEL aufrufen. WdfObjectAcquireLock erhält eine Drehsperre und gibt bei IRQL = DISPATCH_LEVEL zurück.
Weitere Informationen zu Synchronisierungssperren finden Sie unter Synchronisierungstechniken für Framework-Based Drivers.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfsync.h (include Wdf.h) |
| IRQL- | Siehe Abschnitt "Hinweise". |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |