Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►  ◄Changes►               ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_AVIO
 
USHORT VioCreatePS(phvps, cRows, cColumns, fFormat, cAttrBytes, hvps)
PHVPS phvps;         /* pointer to variable for presentation-space handle */
SHORT cRows;         /* height of presentation space                      */
SHORT cColumns;      /* width of presentation space                       */
SHORT fFormat;       /* format of attribute byte(s)                       */
SHORT cAttrBytes;    /* number of attributes                              */
HVPS hvps;           /* presentation-space handle                         */
 
The VioCreatePS function creates an advanced video-input-and-output (AVIO)
presentation space, the size of which must not exceed 64K. To determine the
size of the presentation space, multiply the cColumns, cRows, and
cAttrBytes parameters as follows: cColumns * cRows * (cAttrBytes + 1).
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
phvps       Points to the variable that receives the presentation-space
            handle. You may use this handle in subsequent Vio functions.
 
cRows       Specifies the height (in character cells) of the presentation
            space.
 
cColumns    Specifies the width (in character cells) of the presentation
            space.
 
fFormat     Identifies the format of the attribute byte(s) in the
            presentation space. Currently, the only defined format is zero.
 
cAttrBytes  Specifies the number of attribute bytes per character cell in
            the presentation space. This parameter may be one of the
            following values:
 
            Value         Meaning
            ────────────────────────────────────────────────────────────────
            FORMAT_CGA    Specifies a CGA format of two attribute bytes. The
                          first byte contains the character value. The
                          second byte contains bit fields that specify the
                          background and foreground colors. Blink and
                          intensity fields are not supported.
 
            FORMAT_4BYTE  Specifies an extended format of four attribute
                          bytes. The first byte contains the character
                          value. The second byte contains bit fields that
                          specify the background and foreground colors. The
                          third byte contains bit fields that specify the
                          underscore, reverse video, the background opacity,
                          and the font identifier. The fourth byte is an
                          extra byte to be used by programs.
 
hvps        Identifies the AVIO presentation space. This parameter must be
            zero.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value.
 
See Also
 
VioDestroyPS
 
                                      ♦