drvGetModes 函数 (winddi.h)

项目
08/27/2023

DrvGetModes 函数列出了给定设备支持的模式。

语法

ULONG DrvGetModes(
  [in]            HANDLE   hDriver,
                  ULONG    cjSize,
  [out, optional] DEVMODEW *pdm
);

参数

[in] hDriver

必须枚举其模式的驱动程序的句柄。这是在 DrvEnablePDEV 函数的 hDriver 参数中传递的句柄。

cjSize

指定 pdm 指向的缓冲区的大小（以字节为单位）。

[out, optional] pdm

指向包含 DEVMODEW 结构的缓冲区的指针 (驱动程序要填充的) ，或 为 NULL。

返回值

如果 pdm 不为 NULL，驱动程序应返回写入缓冲区的字节数。如果 pdm 为 NULL，驱动程序应返回保存所有模式数据所需的字节数。如果发生错误，驱动程序应返回零。

注解

必须在所有显示驱动程序中实现此函数。

窗口管理器根据注册表) 中的 InstalledDisplayDrivers 键动态加载与微型端口驱动程序 (关联的所有显示驱动程序。调用每个显示驱动程序以检索加载的驱动程序组合支持的模式列表。例如，VGA64K 显示驱动程序仅返回从微型端口驱动程序获取的模式列表中返回的 64K 颜色模式。

可以在存在活动 PDEV 之前调用 DrvGetModes。

请参阅 Permedia 示例，了解 DrvGetModes 的工作实现。

注意 Microsoft Windows 驱动程序工具包 (WDK) 不包含 3Dlabs Permedia2 (3dlabs.htm ) 和 3Dlabs Permedia3 (Perm3.htm) 示例显示驱动程序。可以从 Windows Server 2003 SP1 驱动程序开发工具包 (DDK) 获取这些示例驱动程序，可以从 WDHC 网站的 DDK - Windows 驱动程序开发工具包页面下载。