Función DescribePixelFormat (wingdi.h)

La función DescribePixelFormat obtiene información sobre el formato de píxel identificado por iPixelFormat del dispositivo asociado a hdc. La función establece los miembros de la estructura PIXELFORMATDESCRIPTOR a la que apunta ppfd con esos datos de formato de píxel.

Sintaxis

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

Parámetros

hdc

Especifica el contexto del dispositivo.

iPixelFormat

Índice que especifica el formato de píxel. Los formatos de píxeles que admite un contexto de dispositivo se identifican mediante índices enteros positivos basados en uno.

nBytes

Tamaño, en bytes, de la estructura a la que apunta ppfd. La función DescribePixelFormat no almacena más de nBytes bytes de datos en esa estructura. Establezca este valor en sizeof(PIXELFORMATDESCRIPTOR).

ppfd

Puntero a una estructura PIXELFORMATDESCRIPTOR cuyos miembros establece la función con datos de formato de píxel. La función almacena el número de bytes copiados en la estructura en el miembro nSize de la estructura. Si, tras la entrada, ppfd es NULL, la función no escribe datos en la estructura. Esto resulta útil cuando solo desea obtener el índice de formato de píxel máximo de un contexto de dispositivo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el índice de formato de píxel máximo del contexto del dispositivo. Además, la función establece los miembros de la estructura PIXELFORMATDESCRIPTOR a la que apunta ppfd según el formato de píxel especificado.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h
Library	Gdi32.lib
Archivo DLL	Gdi32.dll

Consulte también

ChoosePixelFormat

GetPixelFormat

OpenGL en Windows

SetPixelFormat

Funciones de Windows