Función DrvDescribePixelFormat (winddi.h)

La función DrvDescribePixelFormat describe el formato de píxel para un PDEV especificado por el dispositivo escribiendo una descripción del formato de píxel en una estructura PIXELFORMATDESCRIPTOR.

Sintaxis

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

Parámetros

dhpdev

Identifica el dispositivo para el que se solicita información de formato de píxel.

iPixelFormat

Especifica el número de índice del formato de píxel solicitado.

cjpfd

Especifica el número máximo de bytes que se pueden escribir en la estructura a la que apunta ppfd.

ppfd

Puntero a una estructura PIXELFORMATDESCRIPTOR (descrita en la documentación de Microsoft Windows SDK) que va a recibir información sobre el formato de píxel. Este parámetro puede ser NULL.

Valor devuelto

El valor devuelto es el índice de formato de píxel máximo si la función se realiza correctamente. De lo contrario, es cero y se registra un código de error.

Comentarios

Un controlador de pantalla que admite hardware gráfico 3D puede admitir ventanas con formatos de píxeles diferentes en una sola superficie de pantalla. El formato de píxel debe corresponder a una configuración compatible con el hardware gráfico.

DrvDescribePixelFormat rellena la estructura a la que apunta ppfd si este parámetro no es NULL.

Las aplicaciones que necesitan obtener el índice de formato de píxel máximo devuelto pueden usar el índice de formato de píxel máximo del contexto del dispositivo. Los formatos de píxeles que admite un dispositivo se identifican mediante índices enteros positivos basados en uno.

Las funciones de formato de píxeles se usan junto con las funciones de servicios de objetos de ventana para realizar un seguimiento y actualizar formatos de píxeles de ventanas en una superficie de visualización.

Requisitos

Plataforma de destino	Escritorio
Encabezado	winddi.h (incluya Winddi.h)