DiveSwitchBank Return Value - rc

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 Parameter - ulBankNumber]
[Next: DiveSwitchBank - Parameters]