Функция DescribePixelFormat (wingdi.h)
Функция DescribePixelFormat получает сведения о формате пикселей, определяемом iPixelFormat устройства, связанного с hdc. Функция задает элементы структуры PIXELFORMATDESCRIPTOR , на которую указывает ppfd , с данными этого формата пикселей.
Синтаксис
int DescribePixelFormat(
HDC hdc,
int iPixelFormat,
UINT nBytes,
LPPIXELFORMATDESCRIPTOR ppfd
);
Параметры
hdc
Указывает контекст устройства.
iPixelFormat
Индекс, указывающий формат пикселей. Форматы пикселей, поддерживаемые контекстом устройства, определяются положительными одночисленными индексами.
nBytes
Размер структуры в байтах, на которую указывает ppfd. Функция DescribePixelFormat сохраняет в этой структуре не более nBytes байт данных. Задайте для этого параметра значение sizeof(PIXELFORMATDESCRIPTOR).
ppfd
Указатель на структуру PIXELFORMATDESCRIPTOR, члены которой функция задает с данными формата пикселей. Функция сохраняет количество байтов, скопированных в структуру в элементе nSize структуры. Если при вводе ppfd имеет значение NULL, функция не записывает данные в структуру. Это полезно, если требуется получить только максимальный индекс формата пикселей контекста устройства.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение — это максимальный индекс формата пикселей контекста устройства. Кроме того, функция задает элементы структуры PIXELFORMATDESCRIPTOR , на которую указывает ppfd , в соответствии с указанным форматом пикселей.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |