## Display Device Driver Reference for OS/2

[prev][next][parent][TOC]

### DevEnable

This function fills the entries in the Call Vector Table for all of the functions supported by this BVH. It is called as a subfunction of the Presentation Manager enable function entry point. To initialize the Call Vector Table for dynamic link libraries:

        PUSH  DWORD   Parameter2    ; Variable parameter 2
        PUSH  DWORD   Parameter1    ; Variable parameter 1
        PUSH  DWORD   Subfunction   ; Enable subfunction

        CALL  FAR     DevEnable

Parameters

Parameter2 for Subfunction=1

A far pointer to this structure:

        DWORD   Flags Pointer
        DWORD   Call Vector Table

Flags Pointer

Pointer to where the flags that control calls to the Fill Physical Device Block function go.

Call Vector Table

Pointer to the default dispatch table containing the addresses of the default handler functions and the functions supported by this component. Each entry in the Call Vector Table is the far address of a Video Device Handler function, which must be callable from both Ring 2 and Ring 3. The far address of the nth BVH function is the nth DWORD in the table, beginning with Function 0.

The functions listed below are defined as follows:

000h-0FFh (000-255) Reserved for Presentation Manager interface

100h-11Fh (256-287) Reserved for BVS

120h-12Fh (288-303) Reserved for IBM JAPAN

130h-13Fh (304-319) Reserved for MSKK

100h (256) Function 100h Text Buffer Update

101h (257) Function 101h Initialize Environment

102h (258) Function 102h Save Environment

103h (259) Function 103h Restore Environment

104h (260) Function 104h Query Config Info

105h (261) Function 105h DBCS Display Info

106H (262) Function 106h Query Color Lookup Table

107H (263) Function 107h Set Color Lookup Table

108H (264) Function 108h Query Cursor Info

109H (265) Function 109h Set Cursor Info

10AH (266) Function 10Ah Query Font

10BH (267) Function 10Bh Set Font

10CH (268) Function 10Ch Query Mode

10DH (269) Function 10Dh Set Mode

10EH (270) Function 10Eh Query Palette Registers

10Fh (271) Function 10Fh Set Palette Registers

110H (272) Function 110h Query Physical Buffer

111H (273) Function 111h Free Physical Buffer

112H (274) Function 112h Query Variable Info

113H (275) Function 113h Set Variable Info

114H (276) Function 114h Terminate Environment

115H (277) Function 115h Print Screen

116H (278) Function 116h Write TTY

117H (279) Function 117h Query LVB Info
Parameter1 for Subfunction=1

Far pointer to this structure:

        DWORD   Engine Version
        DWORD   Count of Table Functions

Engine Version

Version of the Presentation Manager Graphics Engine.

Count of Table Functions

The number of entries in the passed dispatch table. The driver can write only this many entries into the table.

Subfunction

The Presentation Manager enable subfunction number. Its value must be 1 to start the Presentation Manager Fill Logical Device Block subfunction. All pieces of the BVH must support this function. Pieces of the BVH that do not support the Presentation Manager interface do not need to support the other functions. Any function not supported will return PMERR_DEV_FUNC_NOT_INSTALLED.

Remarks

This function is supported by the video dynamic link functions and is called only once for each adapter supported by the physical device driver. A video device handler determines if the display adapter and that which the adapter supports is present. If not present, this function returns an error . Every part of a BVH must successfully initialize the Call Vector Table for that device to be usable by the OS/2 operating system.