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 non-zero to continue the enumeration.

The callback function returns zero to stop it.

Remarks

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

If UNICODE is defined, the string values will be returned as type LPWSTR rather than LPSTR.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in ddraw.h.
  Import Library: User-defined.

See Also

Enumerating Devices on MultiMon Systems, Multiple Monitor Systems