Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function is an application-defined callback function for the DirectDrawEnumerateExfunction.

Syntax 

BOOL WINAPI DDEnumCallbackEx(
  GUID FAR* 
lpGUID, 
  LPWSTR 
lpDriverDescription, 
  LPWSTR 
lpDriverName, 
  LPVOID 
lpContext, 
  HMONITOR 
hm
);

Parameters

lpGUID

[in] Address of the unique identifier of the DirectDraw object.

lpDriverDescription

[in] Address of a string containing the driver description.

lpDriverName

[in] Address of a string containing the driver name.

lpContext

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

hm

[in] Handle to the monitor associated with the enumerated DirectDraw object.

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

Return Value

The callback function returns nonzero to continue the enumeration.

The callback function returns zero to stop it.

Remarks

You can use the LPDDENUMCALLBACKEXdata type to declare a variable that contains a pointer to this callback function.

Requirements

Header ddraw.h
Library Developer Implemented
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later