RenderWare V2.1

Previous Page Index Next Page

RwDisplayDevice *

RwOpenDisplayDevice(char *devicename, char *initstring);

Description

Opens a display device such that it can be queried for its capabilities and potentially started.

Arguments

device This is the name of the device to be opened. It should be a name that is returned from RwGetDisplayDevices().

init This is a string which is used to select options about a device. This is present to keep compatibility with the previous RenderWare. The string should be used in the same way as the 'device' parameter of RwOpen(). NULL is the usual value.

Return Value

Pointer to a RwDisplayDevice structure on success, NULL otherwise.

Comments

The name of the device should come from using RwExtract() on the string returned by RwGetDisplayDevices(). The device name is what is used for searching for which device driver DLL is used (if loadable device drivers are being used). Each device name maps onto a physical filename. The mapping is dependent on the platform and operating system being used. Look at the platform specific sections for more details.

Note that the library MUST be initialized with RwInitialize() before this function can be used.

See Also

RwCloseDisplayDevice()

RwRelease()

RwInitialize()

RwFindDisplayDevice()

RwGetDisplayDevices()

RwStartDisplayDeviceExt()

RwStartDisplayDevice()

RwStopDisplayDevice()

RwCheckStartDisplayDeviceExt()