DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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