## Presentation Device Driver Reference for OS/2

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

### How This Book is Organized

This book consists of 15 chapters, with supporting appendixes.

Chapters 1 through 11 cover general information about presentation drivers. Chapters 12, 13, 14, and 15 are references detailing each of three classes of presentation driver function:

Exported Driver Functions, Chapter 12

Mandatory and Simulated Graphic Engine Functions, Chapter 13

Device Support Functions, Chapter 14

Bidirectional (BIDI) Command Structures, Chapter 15

Introduction to OS/2 Presentation Drivers This chapter provides general information about presentation drivers, such where they reside in the system, and what they do.

Design Considerations for All Drivers This chapter contains a description of general design considerations for all drivers. and specific design considerations for display and hardcopy presentation drivers.

Graphics Engine/Presentation Driver Design Changes This chapter describes the changes to the graphics engine since the OS/2 2.1 version.

Design Considerations for Display Drivers This chapter contains a description of specific design considerations for display presentation drivers. It also includes an overview about the IBM Distributed Console Access Facility (DCAF) product and the Enhanced Direct Interface Video Extensions (EnDIVE).

Design Considerations for Hardcopy Drivers This chapter contains a description of specific design considerations for hardcopy presentation drivers.

Display Drivers This chapter contains a description of the entry points a display driver must export to the system, so that an application program can query the driver and the system can enable it.

Distributed Console Access Facility (DCAF) Architecture This chapter explains the Distributed Console Access Facility (DCAF), its architecture, and impact on code.

Graphics Engine Hardcopy Drivers This chapter contains a description of the hardcopy drivers that use the graphics engine dispatch table, and the related support functions that are provided by the spooler.

Queue Drivers This chapter contains a description of the functions queue drivers must export so that they can be used by the spooler.

Port Drivers This chapter contains a description of the functions port drivers must export so that they can be used by the Workplace Shell and the spooler.

Presentation Manager Function Categories This chapter discusses the types of functions within each category.

Mandatory Functions for All Drivers This section contains descriptions of the internal functions that must be supported by handling routines in the presentation drivers. These functions must be supported by all presentation drivers.

Mandatory Functions for Display Drivers This section contains a description of additional external functions that must be supported by the display drivers.

Simulated Functions This section contains descriptions of the internal functions that are supported in the graphics engine and that can be hooked by the presentation drivers in order to exploit special features in the target device.

Palette Manager Functions This section contains a description of the Palette Manager and its functions.

Software Motion Video This section describes the function calls provided to support movie-like displays.

Graphics Engine Internal Functions This section contains descriptions of the internal functions that are supported in the graphics engine and that can be called by the presentation drivers.

System Functions This section contains descriptions of the system functions that are available to the presentation drivers.

Exported Driver Function Reference This chapter contains detailed descriptions of the exported entry point functions. These functions are presented alphabetically except for the subfunctions to the "OS2_PM_DRV_ ENABLE" entry point; these are given in ascending hexadecimal order.

Mandatory and Simulated Graphics Engine Function Reference Detailed descriptions of all "mandatory" (must be supported by handling routines in the presentation drivers) and "simulated" (supported by handling routines in the graphics engine) presentation driver functions are given in this chapter. These functions are presented alphabetically.

Device Support Function Reference Detailed descriptions of all device support or "helper" functions are given in this chapter. These functions are presented alphabetically.

BIDI Command Structures and Command Flow Detailed descriptions of all the BIDI command structures are provided in this chapter.
Appendixes

Appendix A. OS/2 Version Compatibility Considerations This table describes information added to or changed since the availability of OS/2 Warp, Version 3 in terms of version compatibility.

Appendix B. Syntax Conventions This appendix shows the conventions that have been used for the parameter names found in the Presentation Manager library.

Appendix C. Format of the Journal File This appendix shows the file format that the OS/2 graphics engine journal functions create in memory or on disk .

Appendix D. Bit Map Simulation for 16-Bit Hardcopy Drivers This appendix contains a description of the bit-map simulation for hardcopy drivers.

Appendix E. Data Types This appendix contains a description of the parameters for all data types.

Appendix F. Notices This appendix contains legal notices and trademark acknowledgements.

Miscellaneous A glossary and an index are included.