DirectX SDK

DirectDrawEnumerate

This function is superseded by the DirectDrawEnumerateEx function.

The DirectDrawEnumerate function enumerates the primary DirectDraw display device and a nondisplay device (such as a 3-D accelerator that has no 2-D capabilities), if one is installed. The NULL entry always identifies the primary display device shared with the GDI.

HRESULT WINAPI DirectDrawEnumerate(
  LPDDENUMCALLBACK lpCallback,  
  LPVOID lpContext              
);

Parameters

lpCallback
Address of a DDEnumCallback function to be called with a description of each enumerated DirectDraw-enabled hardware abstraction layer (HAL).
lpContext
Address of an application-defined context to be passed to the enumeration callback function each time that it is called.

Return Values

If the function succeeds, the return value is DD_OK.

If it fails, the function returns DDERR_INVALIDPARAMS.

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: Use ddraw.lib.

See Also

DirectDrawEnumerateEx