EngCreateSemaphore

HSEMAPHORE EngCreateSemaphore(VOID)

EngCreateSemaphore creates a semaphore object.

Return Value

If the function succeeds, the return value is a handle to the semaphore object. A null pointer is returned if the function fails.

Comments

Graphics drivers can create and use a semaphore object for resource synchronization. For example:

• The S3 display driver uses a semaphore when an asynchronous pointer requires access to the CRTC registers, because these registers are shared by both the asynchronous hardware pointers and the synchronous activities of the device.

• Multiple printer drivers sharing global data, such as font data on a print server, need to synchronize access to this data.

See Also

EngAcquireSemaphore, EngDeleteSemaphore, EngReleaseSemaphore