HAI_Enable_Real_Mode_Access

Allows access to real mode after it has been disabled by HAI_Disable_Real_Mode_Access.

Thread Context:Non-Blocking

Syntax

    LONG HAI_Enable_Real_Mode_Access (
       LONG   npaHandle
       );

Parameters

npaHandle
(IN) The HAM's handle for using the NWPA APIs. Its value was assigned during NPA_Register_HAM_Module.

Return Values

The following table lists return values and descriptions.

zero

Successful completion. Real mode access is no longer disabled by this module.

1

Invalid npaHandle.

2

The HAM had not previously called HAI_Disable_Real_Mode_Access before making this call.

Remarks

HAI_Enable_Real_Mode_Access is used by a module (identified by npaHandle) to allow real mode access again only after it has been disabled by the same module's use of HAI_Disable_Real_Mode_Access. Real mode access should not be disabled for extended periods of time.

HAI_Disable_Real_Mode_Access can be used by multiple modules, so the use of HAI_Enable_Real_Mode_Access does not guarantee that real mode access is allowed. The successful use of this function ensures only that this module is not preventing real mode access.