RenderWare V2.1

Previous Page Index Next Page

RwUInt32

RwFindDisplayDevice(char *devices, RwDeviceCapabilities *request,
char *initstring, void *param, int numargs,
RwOpenArgument *args);

Description

Finds a device which fits the characteristics specified.

Arguments

devices List of semicolon delimited device names. This will usually be the list returned by RwGetDisplayDevices().

request Structure holding the features to be searched for. A 0 value means 'don't care'. Any other value is determined as 'required to be matched'.

initstring The string passed to the display device at startup. NULL will be the usual value.

param Device dependent parameter.

numargs The number of optional arguments specified.

args An array of optional open arguments.

Return Value

The number of the device which fits the characteristics required. 0 if no suitable device was found.

Comments

This function will try and find a device with the characteristics determined by the 'request' structure. A zero in an entry indicates 'don't care'. Thus if a device is requires with any zbuffer depth then set zbuffer_depth to zero.

See Also

RwOpenDisplayDevice()

RwCloseDisplayDevice()

RwRelease()

RwInitialize()

RwStopDisplayDevice()

RwGetDisplayDevices()

RwStartDisplayDeviceExt()

RwStartDisplayDevice()

RwCheckStartDisplayDeviceExt()