Función EngInitializeSafeSemaphore (winddi.h)

La función EngInitializeSafeSemaphore inicializa el semáforo seguro especificado.

Sintaxis

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

Parámetros

[out] pssem

Puntero a la estructura ENGSAFESEMAPHORE asignada por el controlador que se va a inicializar.

Valor devuelto

EngInitializeSafeSemaphore devuelve TRUE tras el éxito. De lo contrario, devuelve FALSE.

Comentarios

EngInitializeSafeSemaphore y EngDeleteSafeSemaphore son seguros para subprocesos, funcionan bajo un bloqueo y mantienen un recuento de referencias en el semáforo. Esto garantiza que solo se cree un semáforo independientemente del número de llamadas simultáneas a él y que el semáforo exista hasta que se libere la última referencia a él.

Una vez inicializado el semáforo seguro, el controlador puede llamar a EngAcquireSemaphore y EngReleaseSemaphore con el miembro hsem de la estructura ENGSAFESEMAPHORE para la sincronización.

Los autores de llamadas de EngInitializeSafeSemaphore deben llamar a EngDeleteSafeSemaphore cuando ya no necesiten el semáforo.

Requisitos

Consulte también

ENGSAFESEMAPHORE

EngAcquireSemaphore

EngDeleteSafeSemaphore

EngIsSemaphoreOwned

EngIsSemaphoreOwnedByCurrentThread

EngReleaseSemaphore