SCO OpenServer
video(D3oddi)
video: DISPLAYED, viddoio, vidinitscreen, vidmap, vidresscreen, vidsavscreen, vidumapinit, vidunmap --
support video adapter driver development
Synopsis
#include <sys/vid.h>
int DISPLAYED(struct mscrn msp);
void viddoio(struct mscrn msp, struct port_io_arg arg,
struct portrange portlist);
void vidinitscreen(struct mscrn msp);
faddr_t vidmap(paddr_t address, unsigned long nbytes);
int vidresscreen(struct mscrn msp);
int vidsavscreen(struct mscrn msp);
faddr_t vidumapinit(int base, int size);
void vidunmap(faddr_t address, int nbytes);
Description
DISPLAYED-
macro that determines
if the screen is displayed.
viddoio-
support I/O control commands
for the adapter driver.
vidinitscreen-
initialize a multiscreen.
vidmap-
return a kernel data pointer to the
virtual memory bound to the specified physical memory range.
Unlike
memget(D3oddi),
no physical memory is added to the kernel address space;
vidmap simply translates
a physical address to a virtual address.
vidresscreen-
call the specified adapter driver to restore the screen.
vidsavscreen-
call the specified adapter driver
to save the screen.
vidumapinit-
return a kernel data pointer
to the virtual memory bound to the specified physical memory range.
vidunmap-
unbind the specified virtual memory range
from physical memory.
This function is the reverse of vidumapinit.
Arguments
msp-
pointer to an instance of
the multiscreen mscrn structure.
arg-
pointer to an instance of the
port_io_arg structure.
portlist-
list of I/O ports,
terminated with the portrange count member
set to 0 (zero).
address-
Beginning of the virtual memory range.
nbytes-
Number of bytes in the virtual memory range.
base-
Physical memory address of the memory range
to which the virtual memory range is bound.
size-
Number of bites of the physical memory range.
address-
Beginning of the virtual memory range.
Return values
DISPLAYED returns TRUE if the screen
is displayed; otherwise it returns FALSE.
viddoio, vidinitscreen and vidunmap do
not return a value.
vidmap returns a virtual address.
vidresscreen returns TRUE if the screen is
restored; otherwise it returns FALSE.
vidsavscreen returns TRUE if the screen is
saved; otherwise it returns FALSE.
vidumapinit returns a kernel data pointer to virtual
memory if successful; otherwise it returns -1.
Hardware applicability
All
Version applicability
oddi:
1, 2, 2mp, 3, 3mp, 4, 4mp, 5, 5mp, 6, 6mp
Differences between versions
Graphics adapter drivers should use the
user-level NFB interface.
See
Developing NFB graphics adapter drivers in Developing NFB graphics adapter drivers.
SVR5 DDI compatibility
These functions are not supported for DDI drivers
on SVR5 systems.
DDI drivers use the NFB interface
to implement video adapter drivers.
References
memget(D3oddi),
sptalloc(D3oddi),
vas(D3oddi)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 5 HDK - June 2005