Platform SDK: DirectX

DDEnumCallback

The DDEnumCallback function is an application-defined callback function for the DirectDrawEnumerate function.

BOOL WINAPI DDEnumCallback(
  GUID FAR *lpGUID,           
  LPSTR  lpDriverDescription, 
  LPSTR  lpDriverName,        
  LPVOID lpContext            
);

Parameters

lpGUID
Address of the unique identifier of the DirectDraw object.
lpDriverDescription
Address of a string that contains the driver description.
lpDriverName
Address of a string that contains the driver name.
lpContext
Address of an application-defined structure to be passed to the callback function each time that the function is called.

Return Values

The callback function returns nonzero to continue the enumeration.

It returns zero to stop the enumeration.

Remarks

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

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

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in ddraw.h.
  Import Library: User-defined.