VioCreatePS: Difference between revisions

Latest revision as of 18:39, 1 January 2020

Creates a VIO presentation space.

Syntax

VioCreatePS(phvps, Rows, Columns, Format, AttrBytes, hvps)

Parameters

phvps (PHVIO) - output

Pointer to the presentation-space handle.

The location where the newly created presentation-space handle is to be returned.

Rows (ULONG) - input

Number of rows.

The number of rows in the presentation space. The maximum value allowed is 255.

Columns (ULONG) - input

Number of columns.

The number of columns in the presentation space. The maximum value allowed is 255.

Format (ULONG) - input

Format of the attributes

The attributes may be one of the following format types:

1 VGA compatible

2 Unicode

3 MFI compatible

AttrBytes (ULONG) - input: Number of attribute bytes.; This is used along with the format to select the attribute structure. This field has a value of 1, 2, or 3.
hvps (HVIO) - input: Reserved. Must be 0.

Return Code

rc (APIRET) - returns: VioCreatePS returns one of the following values:

0 NO_ERROR
421 ERROR_VIO_INVALID_PARMS
436 ERROR_VIO_INVALID_HANDLE

@@ Line 1: / Line 1: @@
-==Description==
 Creates a VIO presentation space.
 ==Syntax==
-<PRE>
+ VioCreatePS(phvps, Rows, Columns, Format, AttrBytes, hvps)
-#define INCL_VIO
-#include <os2.h>
-PHVIO     phvps;      /*  Pointer to the presentation-space handle. */
+===Parameters===
-ULONG     Rows;       /*  Number of rows. */
+;phvps (PHVIO) - output: Pointer to the presentation-space handle.
-ULONG     Columns;    /*  Number of columns. */
-ULONG     Format;     /*  Format of the attributes */
-ULONG     AttrBytes;  /*  Number of attribute bytes. */
-HVIO      hvps;       /*  Reserved.  Must be 0. */
-APIRET    rc;         /*  Return code. */
-rc = VioCreatePS(phvps, Rows, Columns, Format, AttrBytes, hvps);
-</PRE>
-==Parameters==
-; phvps (PHVIO) - output : Pointer to the presentation-space handle.
 :The location where the newly created presentation-space handle is to be returned.
-; Rows (ULONG) - input : Number of rows.
+;Rows ([[ULONG]]) - input: Number of rows.
 :The number of rows in the presentation space. The maximum value allowed is 255.
-; Columns (ULONG) - input : Number of columns.
+;Columns (ULONG) - input : Number of columns.
 :The number of columns in the presentation space. The maximum value allowed is 255.
-; Format (ULONG) - input :  Format of the attributes
+;Format (ULONG) - input : Format of the attributes
 :The attributes may be one of the following format types:
 ::1 VGA compatible
 ::2 Unicode
 ::3 MFI compatible
-; AttrBytes (ULONG) - input : Number of attribute bytes.
+;AttrBytes (ULONG) - input : Number of attribute bytes.
 :This is used along with the format to select the attribute structure. This field has a value of 1, 2, or 3.
-; hvps (HVIO) - input : Reserved. Must be 0.
+;hvps ([[HVIO]]) - input : Reserved. Must be 0.
-==Return Code==
- rc (APIRET) - returns
-VioCreatePS returns one of the following values:
+===Return Code===
-* 0   NO_ERROR
+;rc (APIRET) - returns:VioCreatePS returns one of the following values:
-* 421 ERROR_VIO_INVALID_PARMS
+*0 NO_ERROR
-* 436 ERROR_VIO_INVALID_HANDLE
+*421 ERROR_VIO_INVALID_PARMS
+*436 ERROR_VIO_INVALID_HANDLE
 [[Category:Vio]]