This function enumerates all DirectDraw devices installed on the system. The NULL entry always identifies the primary display device shared with GDI.
HRESULT WINAPI DirectDrawEnumerateEx(LPDDENUMCALLBACKEX lpCallback, LPVOID lpContext,DWORD dwFlags);
Parameters
- lpCallback
[in] Address of a DDEnumCallbackEx function that will be called with a description of each enumerated DirectDraw-enabled HAL. - lpContext
[in] Address of an application-defined value that will be passed to the enumeration callback function each time it is called. - dwFlags
[in] Flags specifying the enumeration scope. This parameter can be zero or a combination of the following flags. If the value is zero, the function will enumerate only the primary display device.Flag Description DDENUM_ATTACHEDSECONDARYDEVICES Enumerates the primary device and any display devices attached to the desktop. DDENUM_DETACHEDSECONDARYDEVICES Enumerates the primary device and any display devices not attached to the desktop. DDENUM_NONDISPLAYDEVICES Enumerates the primary device and nondisplay devices, such as 3-D accelerators that have no 2-D capabilities.
Return Values
If the function succeeds, the return value is DD_OK.
If the function fails, the return value is DDERR_INVALIDPARAMS
Remarks
Retrieve the DirectDrawEnumerateEx function's address from Ddraw.dll by calling the GetProcAddress Win32® function with the DirectDrawEnumerateExA (ANSI) or DirectDrawEnumerateExW (Unicode) process name strings.
If GetProcAddress fails, the installed version of the OS does not support multiple monitors.
The W version of this function in Windows CE provides Unicode support.
Requirements
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddraw.h.
Link Library: Ddraw.lib.
Send Feedback on this topic to the authors