Share via


DirectDrawEnumerateEx

Send Feedback

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.

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 DirectDrawEnumerateEx (Unicode) process name strings.

If GetProcAddress fails, the installed version of the OS does not support multiple monitors.

Requirements

Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later
Header: Ddraw.h.
Library: Ddraw.lib.

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.