EngCreateSemaphore function

The EngCreateSemaphore function creates a semaphore object.

Syntax


HSEMAPHORE EngCreateSemaphore(void);

Parameters

This function has no parameters.

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

Target platform

Universal

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Winddi.h (include Winddi.h)

Library

Win32k.lib

DLL

Win32k.sys

See also

EngAcquireSemaphore
EngDeleteSemaphore
EngIsSemaphoreOwned
EngIsSemaphoreOwnedByCurrentThread
EngReleaseSemaphore

 

 

Send comments about this topic to Microsoft

Show: