Поделиться через

Функция DrvDescribePixelFormat (winddi.h)

  • Статья

Функция DrvDescribePixelFormat описывает формат пикселей для определяемого устройством PDEV путем записи описания формата пикселей в структуру PIXELFORMATDESCRIPTOR.

Синтаксис

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

Параметры

dhpdev

Определяет устройство, для которого запрашиваются сведения о формате пикселей.

iPixelFormat

Указывает номер индекса запрошенного формата пикселей.

cjpfd

Указывает максимальное количество байтов, которые могут быть записаны в структуру, на которую указывает ppfd.

ppfd

Указатель на структуру PIXELFORMATDESCRIPTOR (описанную в документации по Microsoft Windows SDK), которая получает сведения о формате пикселей. Этот параметр может принимать значение NULL.

Возвращаемое значение

Возвращаемое значение — это максимальный индекс формата пикселей, если функция выполнена успешно. В противном случае значение равно нулю и регистрируется код ошибки.

Комментарии

Драйвер дисплея, поддерживающий оборудование трехмерной графики, может поддерживать окна с различными форматами пикселей на одной поверхности дисплея. Формат пикселей должен соответствовать конфигурации, поддерживаемой графическим оборудованием.

DrvDescribePixelFormat заполняет структуру, на которую указывает ppfd , если этот параметр не равен NULL.

Возвращаемый индекс максимального формата пикселей может использоваться приложениями, которым требуется получить индекс максимального формата пикселей контекста устройства. Форматы пикселей, поддерживаемые устройством, определяются положительными одночисленными индексами.

Функции формата пикселей используются в сочетании с функциями служб объектов окна для отслеживания и обновления форматов пикселей окон на поверхности отображения.

Требования

   
Целевая платформа Персональный компьютер
Верхняя часть winddi.h (включая Winddi.h)