通过

DescribePixelFormat 函数 (wingdi.h)

  • 项目

DescribePixelFormat 函数获取与 hdc 关联的设备的 iPixelFormat 标识的像素格式的相关信息。 函数使用该像素格式数据设置 ppfd 指向的 PIXELFORMATDESCRIPTOR 结构的成员。

语法

int DescribePixelFormat(
  HDC                     hdc,
  int                     iPixelFormat,
  UINT                    nBytes,
  LPPIXELFORMATDESCRIPTOR ppfd
);

参数

hdc

指定设备上下文。

iPixelFormat

指定像素格式的索引。 设备上下文支持的像素格式由正从 1 开始的整数索引标识。

nBytes

ppfd 指向的结构的大小（以字节为单位）。 DescribePixelFormat 函数向该结构存储的数据不超过 nBytes 字节。 将此值设置为 sizeof (PIXELFORMATDESCRIPTOR) 。

ppfd

指向 PIXELFORMATDESCRIPTOR 结构的指针，该结构的成员由函数使用像素格式数据进行设置。 函数将复制到结构的 nSize 成员中的字节数存储到结构。 如果在输入时 ppfd 为 NULL，则该函数不会向结构写入任何数据。 当你只想获取设备上下文的最大像素格式索引时，此功能非常有用。

返回值

如果函数成功，则返回值是设备上下文的最大像素格式索引。 此外，函数根据指定的像素格式设置 ppfd 指向的 PIXELFORMATDESCRIPTOR 结构的成员。

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

ChoosePixelFormat

GetPixelFormat

Windows 上的 OpenGL

SetPixelFormat

Windows Functions