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 |