View source for VIOMODEINFO

== VIOMODEINFO ==

Text mode info.

=== Type ===

 [[OS2 API:DataType:USHORT|USHORT]]  cb
 [[OS2 API:DataType:UCHAR|UCHAR]]   fbType
 [[OS2 API:DataType:UCHAR|UCHAR]]   color
 [[OS2 API:DataType:USHORT|USHORT]]  col
 [[OS2 API:DataType:USHORT|USHORT]]  row
 [[OS2 API:DataType:USHORT|USHORT]]  hres
 [[OS2 API:DataType:USHORT|USHORT]]  vres
 [[OS2 API:DataType:UCHAR|UCHAR]]   fmt_ID
 [[OS2 API:DataType:UCHAR|UCHAR]]   attrib
 [[OS2 API:DataType:USHORT|USHORT]]  resv
 [[OS2 API:DataType:ULONG|ULONG]]   buf_addr
 [[OS2 API:DataType:ULONG|ULONG]]   buf_length
 [[OS2 API:DataType:ULONG|ULONG]]   full_length
 [[OS2 API:DataType:ULONG|ULONG]]   partial_length
 [[OS2 API:DataType:ULONG|ULONG]]   ext_data_addr

==== C Declaration Method ====

typedef struct

=== Fields ===
   
 cb              Length of this data structure
                 Input parameter to VioGetMode. Length specifies the length of
                 the data structure in bytes, including length. The value
                 specified on input controls the amount of mode data returned.
                 The minimum structure size required is two bytes. The length is
                 modified on output.

 fbType          Bit mask of mode being set.
                 Mode characteristics bit mask:

                 Bit  Description 
                 7-4  Reserved 
                 3    0 = VGA BIOS compatible modes 
                      1 = Native mode 
                 2    0 = Enable color burst 
                      1 = Disable color burst 
                 1    0 = Text mode 
                      1 = Graphics mode 
                 0    0 = Monochrome compatible mode 
                      1 = Other
   
 color           Number of colors.
                 Number of colors defined as a power of 2. This is equivalent to
                 the number of color bits that define the color, for example:

                 Value  Definition 
                 0      Monochrome 
                 1      2 colors 
                 2      4 colors 
                 4      16 colors 
                 8      256 colors 
                 16     64K colors 
                 24     16M colors
   
 col             The number of text columns.
   
 row             The number of text rows.
   
 hres            Horizontal resolution; the number of pel columns.
   
 vres            Vertical resolution, the number of pel rows.
  
 fmt_ID          Attribute format.
                 The format of the attributes.
   
 attrib          Number of attributes.
                 The number of attributes in a character cell.
   
 resv            Reserved.
   
 buf_addr        Video aperture address.
                 The physical address of the physical display aperture. This may
                 be zero for emulated video hardware.
   
 buf_length      Video aperture length.
                 The length of the physical display aperture.
   
 full_length     Video state full save length.
                 The size of the buffer required for a full save of the video
                 state.
   
 partial_length  Video state partial save length.
                 The size of the buffer required for a partial (pop-up) save of
                 the video state.

 ext_data_addr   Extra data address.
                 The virtual address of an extended mode data structure or zero
                 (if none).. The format of the extended mode data structure is
                 determined by the device driver and is unknown to OS/2.