DrvDescribePixelFormat 函数 (winddi.h)

  • 项目

DrvDescribePixelFormat 函数通过将像素格式说明写入 PIXELFORMATDESCRIPTOR 结构来描述设备指定的 PDEV 的像素格式。

语法

LONG DrvDescribePixelFormat(
  DHPDEV                dhpdev,
  LONG                  iPixelFormat,
  ULONG                 cjpfd,
  PIXELFORMATDESCRIPTOR *ppfd
);

参数

dhpdev

标识为其请求像素格式信息的设备。

iPixelFormat

指定所请求像素格式的索引号。

cjpfd

指定可写入 ppfd 指向的结构的最大字节数。

ppfd

指向用于接收像素格式相关信息的Microsoft Windows SDK文档) 中所述的 PIXELFORMATDESCRIPTOR (结构的指针。 此参数可以为 NULL。

返回值

如果函数成功，则返回值是最大像素格式索引。 否则，它为零，并记录错误代码。

注解

支持 3D 图形硬件的显示驱动程序可以在单个显示图面上支持具有不同像素格式的窗口。 像素格式必须与图形硬件支持的配置相对应。

如果此参数不为 NULL，DrvDescribePixelFormat 将填充 ppfd 指向的结构。

需要获取设备上下文的最大像素格式索引的应用程序可以使用返回的最大像素格式索引。 设备支持的像素格式由正从 1 开始的整数索引标识。

像素格式函数与窗口对象服务函数结合使用，用于跟踪和更新显示图面上窗口的像素格式。

要求

   
目标平台 桌面
标头 winddi.h (包括 Winddi.h)