EngCreateSemaphore function (winddi.h)
The EngCreateSemaphore function creates a semaphore object.
Syntax
ENGAPI HSEMAPHORE EngCreateSemaphore();
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.
Remarks
Graphics drivers can create and use a semaphore object for resource synchronization. For example:
- The Permedia 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.
Note The Microsoft Windows Driver Kit (WDK) does not contain the 3Dlabs Permedia2 (3dlabs.htm ) and 3Dlabs Permedia3 (Perm3.htm) sample display drivers. You can get these sample drivers from the Windows Server 2003 SP1 Driver Development Kit (DDK), which you can download from the DDK - Windows Driver Development Kit page of the WDHC website.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 2000 and later versions of the Windows operating systems. |
| Target Platform | Universal |
| Header | winddi.h (include Winddi.h) |
| Library | Win32k.lib |
| DLL | Win32k.sys |