EngDeleteSafeSemaphore function (winddi.h)

The EngDeleteSafeSemaphore function removes a reference to the specified safe semaphore.

Syntax

ENGAPI VOID EngDeleteSafeSemaphore(
  [in, out] ENGSAFESEMAPHORE *pssem
);

Parameters

[in, out] pssem

Pointer to the ENGSAFESEMAPHORE structure that contains the safe semaphore from which to delete a reference.

Return value

None

Remarks

EngDeleteSafeSemaphore deletes the semaphore only when the last reference to it has been removed.

EngInitializeSafeSemaphore and EngDeleteSafeSemaphore are thread-safe, operating under a lock and maintaining a reference count on the semaphore. This guarantees that only one semaphore is created regardless of the number of simultaneous calls to it, and that the semaphore exists until the last reference to it is released.

Every caller of EngInitializeSafeSemaphore should call EngDeleteSafeSemaphore when it no longer needs the semaphore.

Requirements

See also

ENGSAFESEMAPHORE

EngInitializeSafeSemaphore