DDEnumCallbackEx

The DDEnumCallbackEx function is an application-defined callback function for the DirectDrawEnumerateEx function.

BOOL WINAPI DDEnumCallbackEx(

GUID FAR *lpGUID,

LPSTR lpDriverDescription,

LPSTR lpDriverName,

LPVOID lpContext,

HMONITOR hm)

);

Parameters

lpGUID

Address of the unique identifier of the DirectDraw object.

lpDriverDescription

Address of a string containing the driver description.

lpDriverName

Address of a string containing the driver name.

lpContext

Address of an application-defined structure that will be passed to the callback function each time the function is called.

hm

Handle to the monitor associated with the enumerated DirectDraw object. This parameter will be NULL when the enumerated DirectDraw object is for the primary device, a non-display device (such as a 3-D accelerator with no 2-D capabilities), and devices not attached to the desktop.

Return Values

The callback function returns DDENUMRET_OK to continue the enumeration.

The callback function returns DDENUMRET_CANCEL to stop it.

Remarks

You can use the LPDDENUMCALLBACKEX data type to declare a variable that can contain a pointer to this callback function.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Use Windows 98 or later.
  Windows CE: Unsupported.
  Header: Declared in ddraw.h.
  Import Library: User-defined.

See Also

Enumerating Devices on MultiMon Systems, Multiple Monitor Systems