no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
Last revision | |||
— | en:ibm:prcp:vio:getconfig [2016/02/04 09:52] – created valerius | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ==== VioGetConfig ==== | ||
+ | |||
+ | **Bindings**: | ||
+ | |||
+ | This call returns the video display configuration. | ||
+ | |||
+ | // | ||
+ | |||
+ | // | ||
+ | Identifies for which display configuration information is being requested: | ||
+ | |||
+ | ^Value ^Definition ^ | ||
+ | |0 |Current configuration | | ||
+ | |1 |Primary configuration | | ||
+ | |2 |Secondary configuration | | ||
+ | |||
+ | | ||
+ | For OS/2 1.2, when // | ||
+ | |||
+ | // | ||
+ | Address of structure where the display configuration is returned. | ||
+ | |||
+ | //length// (**USHORT**) | ||
+ | Input parameter to [[en: | ||
+ | |||
+ | The maximum size structure required in OS/2 1.2 is variable and can be determined by issuing [[en: | ||
+ | |||
+ | // | ||
+ | Display adapter type. | ||
+ | |||
+ | ^Value ^Definition ^ | ||
+ | |0 |Monochrome-compatible | | ||
+ | |1 |Color Graphics Adapter (CGA) | | ||
+ | |2 |Enhanced Graphics Adapter (EGA) | | ||
+ | |3 |VGA or PS/2 Display Adapter | | ||
+ | |4-6 |Reserved | | ||
+ | |7 |IBM Personal System/2 Display Adapter 8514/A | | ||
+ | |8 |IBM PS/2 Image Adapter/A | | ||
+ | |9 |IBM PS/2 XGA Display Adapter | | ||
+ | |||
+ | | ||
+ | Values ranging from 0-4095 are reserved for IBM. | ||
+ | |||
+ | // | ||
+ | Display or monitor type. | ||
+ | |||
+ | ^Value ^Definition ^ | ||
+ | |0 |Monochrome display | | ||
+ | |1 |Color display | | ||
+ | |2 |Enhanced Color Display | | ||
+ | |3 |PS/2 Monochrome Display 8503 | | ||
+ | |4 |PS/2 Color Displays 8512 and 8513 | | ||
+ | |5-8 |Reserved | | ||
+ | |9 |PS/2 Color Display 8514 | | ||
+ | |10 |IBM Plasma Display Panel | | ||
+ | |11 |Monochrome Displays 8507 and 8604 | | ||
+ | |12 |PS/2 Color Display 8515 | | ||
+ | |13 |Reserved | | ||
+ | |||
+ | | ||
+ | Values ranging from 0-4095 are reserved for IBM. | ||
+ | |||
+ | // | ||
+ | Amount of memory, in bytes, on the adapter. | ||
+ | |||
+ | // | ||
+ | Number of the display configuration that this data corresponds to. This is assigned by the video subsystem, not the Base Video Handler (BVH). | ||
+ | |||
+ | // | ||
+ | This field is reserved. | ||
+ | |||
+ | //Flag bits// (**USHORT**) | ||
+ | Are defined as follows: | ||
+ | |||
+ | ^Bit ^Description ^ | ||
+ | |15-1 |Reserved | | ||
+ | |0 |Power up display configuration | | ||
+ | |||
+ | //Hardware state buffer size// (**ULONG**) | ||
+ | Size of the buffer required by the Base Video Handler (BVH) to save the full hardware state excluding the physical display buffer. | ||
+ | |||
+ | //Max buffer size - full save// (**ULONG**) | ||
+ | Maximum size buffer required by the BVH to save the full physical display buffer. | ||
+ | |||
+ | //Max buffer size - partial save// (**ULONG**) | ||
+ | Maximum size buffer required by the BVH to save the portion of the physical display buffer that is overlaid by a pop-up. | ||
+ | |||
+ | //Offset to emulated adapter types// (**USHORT**) | ||
+ | Offset within the configuration data structure to the following information describing what other display adapters are emulated by this display adapter. | ||
+ | |||
+ | //Number of Data words// (**USHORT**) | ||
+ | Contains a one word field specifying a count of data words to follow. | ||
+ | |||
+ | //Data word 1// (**USHORT**) | ||
+ | Bits set in the data words identify display adapters emulated. Data word 1 has the following definition: | ||
+ | |||
+ | ^Bit ^Description ^ | ||
+ | |0 |Monochrome/ | ||
+ | |1 |Color graphics adapter | | ||
+ | |2 |Enhanced graphics adapter | | ||
+ | |3 |VGA or PS/2 display adapter | | ||
+ | |4-6 |Reserved | | ||
+ | |7 |8514/A Adapter | | ||
+ | |8 |IBM PS/2 Image Adapter/A | | ||
+ | |9 |IBM PS/2 XGA Adapter | | ||
+ | |10-15 |Reserved | | ||
+ | |||
+ | //Data word 2// (**USHORT**) | ||
+ | Reserved. | ||
+ | |||
+ | //Data word N// (**USHORT**) | ||
+ | Reserved. | ||
+ | |||
+ | //Offset to emulated display types// (**USHORT**) | ||
+ | Offset within the configuration data structure to the following information describing what other displays are emulated by this display. | ||
+ | |||
+ | //Number of Data words// (**USHORT**) | ||
+ | One word field specifying a count of data words to follow. | ||
+ | |||
+ | //Data word 1// (**USHORT**) | ||
+ | Bits set in the data words identify displays emulated. Data word 1 has the following definition: | ||
+ | |||
+ | ^Bit ^Description ^ | ||
+ | |0 |5151 monochrome display | | ||
+ | |1 |5153 color display | | ||
+ | |2 |5154 enhanced color display | | ||
+ | |3 |8503 monochrome display | | ||
+ | |4 |8512 or 8513 color display | | ||
+ | |5-8 |Reserved | | ||
+ | |9 |8514 color display | | ||
+ | |10 |IBM Plasma Display Panel | | ||
+ | |11 |Monochrome Displays 8507 and 8604 | | ||
+ | |12 |8515 color display | | ||
+ | |13-15 |Reserved | | ||
+ | |||
+ | //Data word 2// (**USHORT**) | ||
+ | Reserved | ||
+ | |||
+ | //Data word N// (**USHORT**) | ||
+ | Reserved. | ||
+ | |||
+ | // | ||
+ | This must be zero unless the caller is a Presentation Manager application, | ||
+ | |||
+ | //rc// (**USHORT**) - return | ||
+ | Return code descriptions are: | ||
+ | |||
+ | |0 |NO_ERROR | | ||
+ | |421 |ERROR_VIO_INVALID_PARMS | | ||
+ | |436 |ERROR_VIO_INVALID_HANDLE | | ||
+ | |438 |ERROR_VIO_INVALID_LENGTH | | ||
+ | |465 |ERROR_VIO_DETACHED | | ||
+ | |||
+ | **Remarks** | ||
+ | |||
+ | The values returned may not be correct if the adapter cannot be properly identified by the Base Video Handler (BVH) selected at system installation time. It can also be incorrect if the physical setup does not match that indicated by the presence of the adapter or by adapter switches. For example, it is impossible to detect the absence of a display on a CGA or the display attached to an EGA, despite the setup switches. | ||