External Stubs for DRI sub driver

Data Structures
struct	_DrmSurfaceBuffer
struct	_DrmDriverOps

Macros
#define	DRM_DRIVER_VERSION   1

Typedefs
typedef struct _DrmSurfaceBuffer	DrmSurfaceBuffer
typedef struct _DrmDriverOps	DrmDriverOps

Functions
DrmDriverOps *	__drm_ex_driver_get (const char *driver_name, int device_fd, int *version)

Detailed Description

Macro Definition Documentation

DRM_DRIVER_VERSION

#define DRM_DRIVER_VERSION   1

The current version of DRM driver.

Definition at line 355 of file exstubs.h.

Typedef Documentation

DrmDriverOps

typedef struct _DrmDriverOps DrmDriverOps

The structure type defines the operations for a DRM driver.

DrmSurfaceBuffer

typedef struct _DrmSurfaceBuffer DrmSurfaceBuffer

The structure type represents the buffer can be used by MiniGUI NEWGAL DRM engine for a hardware surface.

Function Documentation

__drm_ex_driver_get()

DrmDriverOps* __drm_ex_driver_get	(	const char *	driver_name,
		int	device_fd,
		int *	version
	)

Implement this stub to return the DRI driver operations

This function takes three arguments and returns NULL or a valid pointer of DrmDriverOps to MiniGUI.

This function can return different DrmDriverOps to MiniGUI according to the driver name and device file descriptor. In this way, your DRM engine driver implementation can support multiple GPUs.

If the external stub returns NULL, MiniGUI will try to use the dumb frame buffer instead.

Parameters

driver_name	This argument gives the driver name determined by MiniGUI. Generally, it is the kernel driver name for your GPU. For example, for Intel i915/i965 GPUs, the driver name will be i915.
device_fd	This argument gives the file descriptor of the opened DRI device.
version	A pointer to an integer which will be used to return the interface version of the DRM engine driver.

Returns

NULL or a valid pointer to DrmDriverOps.

Note

We use the version control since 4.0.7. It will be initialized to zero by MiniGUI before calling this function. Because an old driver for MiniGUI 4.0.6 or earlier will not change the value, MiniGUI will deny to load the old driver.

The constant DRM_DRIVER_VERSION defines the current version code.