EngInitializeSafeSemaphor-Funktion (winddi.h)

Artikel
03/13/2024

Die EngInitializeSafeSemaphor-Funktion initialisiert den angegebenen sicheren Semaphor.

Syntax

ENGAPI BOOL EngInitializeSafeSemaphore(
  [out] ENGSAFESEMAPHORE *pssem
);

Parameter

[out] pssem

Zeiger auf die vom Treiber zugewiesene ENGSAFESEMAPHORE-Struktur , die initialisiert werden soll.

Rückgabewert

EngInitializeSafeSemaphore gibt bei Erfolg TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

EngInitializeSafeSemaphor und EngDeleteSafeSemaphor sind threadsicher, arbeiten unter einer Sperre und verwalten eine Verweisanzahl auf dem Semaphor. Dadurch wird sichergestellt, dass unabhängig von der Anzahl der gleichzeitigen Aufrufe nur ein Semaphor erstellt wird und dass der Semaphor vorhanden ist, bis der letzte Verweis darauf freigegeben wird.

Nachdem der sichere Semaphor initialisiert wurde, kann der Treiber EngAcquireSemaphore und EngReleaseSemaphore mit dem hsem-Member der ENGSAFESEMAPHORE-Struktur zur Synchronisierung aufrufen.

Aufrufer von EngInitializeSafeSemaphore sollten EngDeleteSafeSemaphor aufrufen , wenn sie den Semaphor nicht mehr benötigen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys