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 |