DDEnumCallbackEx

This 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
    [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 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 for devices not attached to the desktop.

Return Values

The callback function returns nonzero 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 contains a pointer to this callback function.

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

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddraw.h.
Link Library: User-defined.

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.