VideoPortAcquireSpinLock-Funktion (video.h)

Die VideoPortAcquireSpinLock-Funktion ruft die angegebene Drehsperre ab.

Syntax

VIDEOPORT_API VOID VideoPortAcquireSpinLock(
  [in, out] PVOID      HwDeviceExtension,
  [in]      PSPIN_LOCK SpinLock,
  [out]     PUCHAR     OldIrql
);

Parameter

[in, out] HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] SpinLock

Zeiger auf einen Speicherort, der die Drehsperre enthält.

[out] OldIrql

Zeiger auf einen Speicherspeicherort, der die aktuelle IRQL empfängt.

Rückgabewert

Keine

Bemerkungen

Die aktuelle IRQL wird in OldIrql gespeichert. Anschließend wird die aktuelle IRQL auf DISPATCH_LEVEL zurückgesetzt, und die angegebene Drehsperre wird abgerufen.

Der OldIrql-Wert muss angegeben werden, wenn die Drehsperre mit VideoPortReleaseSpinLock freigegeben wird.

Spinsperren können schwerwiegende Probleme verursachen, wenn sie nicht vernünftig verwendet werden. Insbesondere wird kein Deadlockschutz ausgeführt und die Verteilung deaktiviert, während die Drehsperre gehalten wird. Deshalb gilt Folgendes:

• Der Code in einem kritischen Bereich, der durch eine Spin-Sperre geschützt wird, darf weder ausgelagert werden können noch verweise auf auslagerungsfähige Daten enthalten.
• Der Code in einem kritischen Bereich, der durch eine Spin-Sperre geschützt wird, kann weder externe Funktionen aufrufen, die auf auslagerungsfähige Daten zugreifen oder eine Ausnahme auslösen, noch kann er Ausnahmen generieren.
• Der Aufrufer sollte die Drehsperre mit VideoPortReleaseSpinLock so schnell wie möglich freigeben.

Anforderungen

Weitere Informationen

VideoPortAcquireSpinLockAtDpcLevel

VideoPortReleaseSpinLock