DiveSwitchBank - Parameters

hDiveInst (HDIVE) - input

Display engine DIVE instance.

ulBankNumber (ULONG) - input

Bank index to switch to.

rc (ULONG) - returns

This function returns an error return code if any of the following conditions are met:

• Direct-screen access through the DIVE or EnDIVE dev_escapes are unavailable.

• The current hDiveInst has not issued DiveAcquireFrameBuffer.

• The frame buffer consists of a single aperture.
Return codes indicating success or type of failure:

DIVE_SUCCESS

If the function succeeds, 0 is returned.
DIVE_ERR_INVALID_INSTANCE
The DIVE instance handle specified in the hDiveInst parameter is invalid.
DIVE_ERR_BANK_SWITCH_FAILED
The bank could not be switched to the specified parameters.
DIVE_ERR_NO_DIRECT_ACCESS
The display adapter, display driver, or current video mode does not support direct-to-screen access.

---

[Back: DiveSwitchBank Return Value - rc]
[Next: DiveSwitchBank - Remarks]