On-line справка по OpenGL

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-L-M-N-O-P-R-S-T-U-V-W | Скачать

DescribePixelFormat

The DescribePixelFormat function obtains information about the pixel format identified by iPixelFormat of the device associated with hdc. The function sets the members of the PIXELFORMATDESCRIPTOR structure pointed to by ppfd with that pixel format information.

int DescribePixelFormat(

HDC hdc, //Device context of interest
int iPixelFormat, //Pixel format selector
UINT nBytes, //Size of buffer pointed to by ppfd
LPPIXELFORMATDESCRIPTOR ppfd //Pointer to structure to receive pixel format data
);

Parameters

hdc

Specifies the device context of interest.

iPixelFormat

Index that specifies the pixel format of interest. The pixel formats that a device context supports are identified by positive one-based integer indices.

nBytes

Specifies the size, in bytes, of the structure pointed to by ppfd. The function stores data to that structure; it stores no more than nBytes bytes. Set this value to sizeof(PIXELFORMATDESCRIPTOR).

ppfd

Pointer to a PIXELFORMATDESCRIPTOR structure whose members the function sets with pixel format data. The function stores the number of bytes copied to the structure in the structure's nSize field. If, upon entry, ppfd is NULL, the function writes no data to the structure. This is useful when an application only wants to obtain a device context's maximum pixel format index.

Return Value

If the function succeeds, the return value is the device context's maximum pixel format index. In addition, the function sets the members of the PIXELFORMATDESCRIPTOR structure pointed to by ppfd according to the specified pixel format.
If the function fails, the return value is zero. Call GetLastError for extended error information.

Remarks

Here's a skeletal example of DescribePixelFormat usage:

PIXELFORMATDESCRIPTOR pfd;
HDC hdc;
int iPixelFormat;

iPixelFormat = 1;

// obtain detailed information about
// the device context's 1st pixel format
DescribePixelFormat(hdc, iPixelFormat,
sizeof(PIXELFORMATDESCRIPTOR), &pfd);

See Also

ChoosePixelFormat, GetPixelFormat, SetPixelFormat

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

DescribePixelFormat

Функция DescribePixelFormat получает информацию о формате пикселя идентифицированном iPixelFormat устройства связанном hdc. Функция устанавливает участников структуры PIXELFORMATDESCRIPTOR указанной, чтобы ppfd с этой информацией формата пикселя.

int DescribePixelFormat(

HDC hdc, //КОНТЕКСТ Устройства интереса int iPixelFormat, //Пиксель форматирует селектор UINT nBytes, //Размер буфера указывался, чтобы ppfd LPPIXELFORMATDESCRIPTOR ppfd //Указателем в структуру, чтобы получать данные формата пикселя
);

Параметры

hdc

Определяет контекст устройства интереса.

iPixelFormat

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

nBytes

Определяет размер, в байтах, структуры указанной, чтобы ppfd. Функция загружает данные в эту структуру; это загружает не более чем байты nBytes. Установите эту величину, чтобы sizeof(PIXELFORMATDESCRIPTOR).

ppfd

Указатель в структуру PIXELFORMATDESCRIPTOR чьих участников функция устанавливается с данными формата пикселя. Функция загружает количество байтов скопированных в структуру в структурной области nSize. Если, на входе, ppfd НЕДЕЙСТВИТЕЛЬНО, функция не записывает никакие данные в структуру. Это полезное когда приложение только хочет получать контекстный максимальный пиксель формата устройства индекса.

Обратная Величина

Если функция добивается успеха, обратная величина является контекстным максимальным пикселем формата устройства индекса. Кроме того, функция устанавливает участников структуры PIXELFORMATDESCRIPTOR указанной, чтобы ppfd согласно определенному формату пикселя.
Если функция терпит неудачу, обратная величина нулевая. Призовите GetLastError к расширенной информации ошибки.

Замечания

Вот скелетный пример использования DescribePixelFormat:

pfd PIXELFORMATDESCRIPTOR;
hdc HDC;
int iPixelFormat;

iPixelFormat = 1;

// получите подробную информацию о // устройство контекст 1-й формат пикселя DescribePixelFormat(hdc, iPixelFormat, sizeof(PIXELFORMATDESCRIPTOR), &pfd);

Смотри Также

ChoosePixelFormat, GetPixelFormat, SetPixelFormat