IHTMLScreen::bufferDepth Property

Sets or retrieves the number of bits per pixel used for colors in the off-screen bitmap buffer.

Syntax


HRESULT IHTMLScreen::get_bufferDepth(long *p);HRESULT IHTMLScreen::put_bufferDepth(long v);

Parameters

p
Pointer to a variable of type long that receives one of the values listed in Possible Values.
v
long that specifies one of the values listed in Possible Values.

Possible Values

0 Default. No explicit buffering occurs. The IHTMLScreen::colorDepth property is set to the screen depth.
-1 Buffering occurs at screen depth. The IHTMLScreen::colorDepth property is set to the screen depth.
1, 4, 8, 15, 16, 24, 32 Number of bits per pixel to use for the off-screen buffer. The IHTMLScreen::colorDepth property is also set to this value. The value 15 specifies 16 bits per pixel, in which only 15 bits are used in a 5-5-5 layout of RGB values.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Nonsupported values cause IHTMLScreen::bufferDepth to be set to -1.

When IHTMLScreen::bufferDepth is -1 and the user changes system settings that affect the screen depth, the buffer depth is automatically updated to the new depth. This is not the case if IHTMLScreen::bufferDepth is set to a specific value.

Community Additions

Show: