ulSubfunction (ULONG) - input

0Ch.

pParam1 (PLONG) - input

A pointer to the following data structure:

ulVersion

Version number in binary coded decimal (BCD) of the graphics engine.
comptype
A structure consisting of two short flag variables:

fEngine32Bit

This flag will always be true.
fDriver32Bit
This flag is set if the current display driver is a 32-bit driver.

pParam2 (PLONG) - input

A pointer to the dispatch tables of the display driver and graphics engine:

pEngHooks

Pointer to the 32-bit entry points of the graphics engine.
pDrvHooks
Pointer to the entry points of the current display driver, which can consist of a table of 16-bit or 32-bit entry points:

typedef struct _CompType {
    USHORT fEngine32Bit;
    USHORT fDriver32Bit;
} COMPTYPE;

typedef struct _P1 {
    ULONG    version;
    COMPTYPE comptype;
} P1;

typedef struct _P2 {
    PLONG pEngTable;
    PLONG pDrvTable;
} P2;

rc (LONG) - returns

Return codes.

The return value is 0 if the function is successful; otherwise, it is an error value.

If the error returned = PMERR_DRVR_NOT_SUPPORTED, the graphics engine will unload the hooking DLL and work as though no routine were installed. This would be the case if the hooking DLL only handled 32-bit entry points and received a display dispatch table of 16-bit entry points.

---

[Back: OS2_PM_DRV_ENABLE: Subfunction 0Ch - InstallPMEngineDisplayHooks Return Value - rc]
[Next: OS2_PM_DRV_ENABLE: Subfunction 0Ch - InstallPMEngineDisplayHooks - Remarks]