Freigeben über


EngInitializeSafeSemaphor-Funktion (winddi.h)

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

Weitere Informationen

ENGSAFESEMAPHOR

EngAcquireSemaphor

EngDeleteSafeSemaphor

EngIsSemaphoreOwned

EngIsSemaphoreOwnedByCurrentThread

EngReleaseSemaphor