VioSetState

Sets one or more of the following states:

• Blink and background intensity switch
• Colour registers
• Overscan (border) colour
• Palette registers
• Target VioSetMode display configuration
• Underline location

Syntax

VioSetState(RequestBlock, VioHandle)

Parameters

RequestBlock (PVIOD) - input

Address of the video state structures (consisting of six different structures, depending on the request type):

Type	Definition
0	Set palette registers
1	Set overscan (border) colour
2	Set blink/background intensity switch
3	Set colour registers
4	Reserved
5	Set underline location
6	Set target VioSetMode display configuration

The six structures, depending on request type, are:

• VIOPALSTATE
• VIOOVERSCAN
• VIOINTENSITY
• VIOCOLORREG
• VIOSETULINELOC
• VIOSETTARGET

VioHandle (HVIO) - input

VIO presentation-space handle

Reserved. Must be 0.

Return Code

rc (APIRET) - returns

VioSetState returns one of the following values:

0	NO_ERROR
355	ERROR_VIO_MODE
421	ERROR_VIO_INVALID_PARMS
436	ERROR_VIO_INVALID_HANDLE
438	ERROR_VIO_INVALID_LENGTH

Remarks

VioSetState allows setting of hardware-dependent features. Not all video hardware will honour these settings.