Entry | |
---|---|
R0 | 11 |
R1 | New GraphicsV Device / VideoV Display number, or -1 to read current |
Exit | |
---|---|
R1 | Previous (or current, if reading) driver number |
All other registers preserved |
The purpose of this call is to select the active video driver, or to return the current driver.
An error will be returned if the selected Device or Display does not exist, or if the driver refuses to activate.
On RISC OS 5 this selects which GraphicsV Device driver is in use, while on RISC OS Select this selects which VideoV? Display driver is in use.
On RISC OS 5 the value -2 will be returned in R1 if no driver is active. -2 can also be passed in to deactivate the video system, however this is inadvisable as the OS does not fully cope with no driver being active.
Under both RISC OS 5 and RISC OS Select, Service_DisplayChanged will be issued as appropriate in order to notify the rest of the system that the current driver is changing.