DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

ddxScreenRequest(D4nfb)


ddxScreenRequest -- graphics driver initialization information for SYS layer

Synopsis

#include "ddxScreen.h"

Description

The ddxScreenRequest structure is passed into the xxxProbe routine for every DDX layer loaded. It contains information from the SYS layer that is needed for the driver to initialize the board. This structure is initialized by the SYS module by reading the grafinfo(DSP/4dsp) file and command line arguments. Your xxxProbe routine supplies a pointer to this structure as an argument.

Structure definition

typedef struct _ddxScreenRequest {
	char *mode;
	char *type;
	unsigned char ddxLoad;
	unsigned char boardNum;
	unsigned char dfltClass;
	unsigned char dfltDepth;
	unsigned char dfltBpp;
	unsigned char dfltPad;
	unsigned char nextLeft;
	unsigned char nextRight;
	unsigned char nextAbove;
	unsigned char nextBelow;
	grafData *grafinfo;
} ddxScreenRequest;

Structure members

The members are:

*mode
grafinfo mode string being used by this adapter. The format is vendor.model.class.mode. For example, trident.impact.svga.1024x768-256.

*type
character driver name. This must consist of no fewer than three characters and no more than five and is taken from the value of the XDRIVER field in the grafinfo(DSP/4dsp) file.

ddxLoad
type of driver being used. Valid values are DDX_LOAD_STATIC or DDX_LOAD_DYNAMIC.

boardNum
number of the board you initialized. Determined by the order in which the grafinfo mode string appears in the grafdev file.

dfltClass
visual class of this adapter mode. Obtained from the grafinfo file's VISUAL field.

dfltDepth
support depth of this adapter mode. Obtained from the grafinfo file's DEPTH field.

dfltBpp
number of bits needed to represent a pixel. Calculated from DEPTH. Legal values are 1, 4, 8, 16, and 32.

dfltPad
number of bits to which pixmaps must be padded. Typical value is 32.

nextLeft
screen to the left of this one. Reserved for possible future support of multihead.

nextRight
screen to the right of this one. Reserved for possible future support of multihead.

nextAbove
screen above this one. Reserved for possible future support of multihead.

nextBelow
screen below this one. Reserved for possible future support of multihead.

*grafinfo
pointer to the grafinfo data.

Version applicability

This structure is supported for NFB drivers on all releases of SCO OpenServer 5, SVR5, and AIX 5L.

References

ddxScreenInfo(D4nfb)

``Initializing the hardware'' in Developing NFB graphics adapter drivers


19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005