DirectDrawEnumerateEx出自DirectX SDK。
列举已安装的所有DirectDraw设备。NULL入口通常指定与GDI共享的主显示设备。
HRESULT WINAPI DirectDrawEnumerateEx(
LPDDENUMCALLBACKEX lpCallback,
LPVOID lpContext,
DWORD dwFlags
);
参数:
lpCallback
DDEnumCallbackEx回调函数的地址,每列举出一个模式的时候,将执行该函数,并且传递一个DirectDraw HAL的描述。
lpContext
一个应用程序定义的结构的地址,用来传递给列举的回调函数。
dwFlags
指定列举的范围。该参数可以是0或下列标志的组合:
0
该函数将只列举出主显示设备和一个已安装的非显示设备。
DDENUM_ATTACHEDSECONDARYDEVICES
该函数将列举出主设备,和任何隶属于桌面的显示设备。
DDENUM_DETACHEDSECONDARYDEVICES
该函数将列举出主设备,和任何不隶属于桌面的显示设备。
DDENUM_NONDISPLAYDEVICES
该函数将列举出非显示设备,比如不带2-D特性的3-D加速卡。
返回值:
如果函数调用成功,返回DD_OK。
如果函数调用失败,返回DDERR_INVALIDPARAMS。
备注:
在多显示器系统上,该函数列举出多显示设备。要得到更多资料,请参阅“多显示器系统”。
该函数只被Windows98和Windows NT 5.0支持。调用GetProcAddress Win32函数(指定"DirectDrawEnumerateExA" (ANSI)或"DirectDrawEnumerateExW" (Unicode) 过程名称字符串)可以从Ddraw.dll动态连接库获得DirectDrawEnumerateEx函数的地址。如果失败,则表明安装的操作系统的版本不支持多显示器。要得到更多的资料,请参阅“在多显示器系统上列举设备”。
快速信息:
Windows NT:适用于5.0或更新版
Windows:适用于Windows 98或更新版
Windows CE:不支持
头文件:ddraw.h
库文件:ddraw.lib