DVD subsystem. More...

#include <gctypes.h>
#include <ogc/lwp_queue.h>
#include <ogc/disc_io.h>

Data Structures
struct	_dvdcmdblk

struct	_dvddiskid

struct	_dvddrvinfo

struct	_dvdfileinfo

Macros
#define	DEVICE_TYPE_GAMECUBE_DVD (('G'<<24)\|('D'<<16)\|('V'<<8)\|'D')

#define	DVD_ERROR_CANCELED -3

#define	DVD_ERROR_COVER_CLOSED -4

#define	DVD_ERROR_FATAL -1

#define	DVD_ERROR_IGNORED -2

#define	DVD_ERROR_OK 0

#define	DVD_GetUserData(block) ((block)->usrdata)

#define	DVD_RESETHARD 0

#define	DVD_RESETNONE 2

#define	DVD_RESETSOFT 1

#define	DVD_SetUserData(block, data) ((block)->usrdata = (data))

#define	DVD_SPINMOTOR_ACCEPT 0x00004000

#define	DVD_SPINMOTOR_CHECKDISK 0x00008000

#define	DVD_SPINMOTOR_DOWN 0x00000000

#define	DVD_SPINMOTOR_UP 0x00000100

#define	DVD_STATE_BUSY 1

#define	DVD_STATE_CANCELED 10

#define	DVD_STATE_COVER_CLOSED 3

#define	DVD_STATE_COVER_OPEN 5

#define	DVD_STATE_END 0

#define	DVD_STATE_FATAL_ERROR -1

#define	DVD_STATE_IGNORED 8

#define	DVD_STATE_MOTOR_STOPPED 7

#define	DVD_STATE_NO_DISK 4

#define	DVD_STATE_RETRY 11

#define	DVD_STATE_WAITING 2

#define	DVD_STATE_WRONG_DISK 6

Typedefs
typedef void(*	dvdcallback) (s32 result, dvdfileinfo *info)
	function pointer typedef for the user's DVD operation callback More...

typedef void(*	dvdcbcallback) (s32 result, dvdcmdblk *block)
	function pointer typedef for the user's operations callback

typedef struct _dvdcmdblk	dvdcmdblk
	forward typedef for struct _dvdcmdblk More...

typedef struct _dvddiskid	dvddiskid
	forward typedef for struct _dvddiskid More...

typedef struct _dvddrvinfo	dvddrvinfo
	forward typedef for struct _dvddrvinfo More...

typedef struct _dvdfileinfo	dvdfileinfo
	forward typedef for struct _dvdfileinfo More...

Functions
s32	DVD_CancelAllAsync (dvdcbcallback cb)

s32	DVD_ControlDrive (dvdcmdblk *block, u32 cmd)
	Controls the drive's motor and behavior. More...

s32	DVD_ControlDriveAsync (dvdcmdblk *block, u32 cmd, dvdcbcallback cb)
	Controls the drive's motor and behavior. More...

s32	DVD_GetCmdBlockStatus (dvdcmdblk *block)

dvddiskid *	DVD_GetCurrentDiskID (void)

dvddrvinfo *	DVD_GetDriveInfo (void)

s32	DVD_GetDriveStatus (void)

void	DVD_Init (void)
	Initializes the DVD subsystem. More...

s32	DVD_Inquiry (dvdcmdblk block, dvddrvinfo info)

s32	DVD_InquiryAsync (dvdcmdblk block, dvddrvinfo info, dvdcbcallback cb)

s32	DVD_Mount (void)
	Mounts the DVD drive. More...

s32	DVD_MountAsync (dvdcmdblk *block, dvdcbcallback cb)
	Mounts the DVD drive. More...

void	DVD_Pause (void)

s32	DVD_ReadAbsAsyncForBS (dvdcmdblk block, void buf, u32 len, s64 offset, dvdcbcallback cb)

s32	DVD_ReadAbsAsyncPrio (dvdcmdblk block, void buf, u32 len, s64 offset, dvdcbcallback cb, s32 prio)

s32	DVD_ReadDiskID (dvdcmdblk block, dvddiskid id, dvdcbcallback cb)

s32	DVD_ReadPrio (dvdcmdblk block, void buf, u32 len, s64 offset, s32 prio)

void	DVD_Reset (u32 reset_mode)
	Performs a reset of the drive and FW respectively. More...

s32	DVD_SeekAbsAsyncPrio (dvdcmdblk *block, s64 offset, dvdcbcallback cb, s32 prio)

s32	DVD_SeekPrio (dvdcmdblk *block, s64 offset, s32 prio)

u32	DVD_SetAutoInvalidation (u32 auto_inv)

s32	DVD_SetGCMOffset (dvdcmdblk *block, s64 offset)

s32	DVD_SetGCMOffsetAsync (dvdcmdblk *block, s64 offset, dvdcbcallback cb)

s32	DVD_SpinUpDrive (dvdcmdblk *block)

s32	DVD_SpinUpDriveAsync (dvdcmdblk *block, dvdcbcallback cb)

s32	DVD_StopStreamAtEnd (dvdcmdblk *block)

s32	DVD_StopStreamAtEndAsync (dvdcmdblk *block, dvdcbcallback cb)

Variables
const DISC_INTERFACE	__io_gcdvd

Detailed Description

DVD subsystem.

Typedef Documentation

◆ dvdcallback

void(* dvdcallback)(s32 result, dvdfileinfo *info)

function pointer typedef for the user's DVD operation callback

Parameters

[in]	result	error code of last operation
[in]	info	pointer to user's file info strucutre

◆ dvdcmdblk

struct _dvdcmdblk dvdcmdblk

forward typedef for struct _dvdcmdblk

   This structure is used internally to control the requested operation.

◆ dvddiskid

struct _dvddiskid dvddiskid

forward typedef for struct _dvddiskid

   This structure holds the game vendors copyright informations.<br>
   Additionally it holds certain parameters for audiocontrol and<br>
   multidisc support.

Parameters

gamename[4]	vendors game key
company[2]	vendors company key
disknum	number of disc when multidisc support is used.
gamever	version of game
streaming	flag to control audio streaming
streambufsize	size of buffer used for audio streaming
pad[22]	padding

◆ dvddrvinfo

struct _dvddrvinfo dvddrvinfo

forward typedef for struct _dvddrvinfo

   This structure structure holds the drive version infromation.<br>
      Use DVD_Inquiry() to retrieve this information.

Parameters

rev_leve	revision level
dev_code	device code
rel_date	release date
pad[24]	padding

◆ dvdfileinfo

struct _dvdfileinfo dvdfileinfo

forward typedef for struct _dvdfileinfo

   This structure is used internally to control the requested file operation.

Function Documentation

◆ DVD_ControlDrive()

s32 DVD_ControlDrive	(	dvdcmdblk *	block,
		u32	cmd
	)

Controls the drive's motor and behavior.

   This is a synchronous version of DVD_ControlDriveAsync().

Parameters

[in]	block	pointer to a dvdcmdblk structure used to process the operation
[in]	cmd	command to control the drive.

Returns: none

◆ DVD_ControlDriveAsync()

s32 DVD_ControlDriveAsync	(	dvdcmdblk *	block,
		u32	cmd,
		dvdcbcallback	cb
	)

Controls the drive's motor and behavior.

Parameters

[in]	block	pointer to a dvdcmdblk structure used to process the operation
[in]	cmd	command to control the drive.
[in]	cb	callback to be invoked upon completion of operation.

Returns: none

◆ DVD_Init()

void DVD_Init ( void )

Initializes the DVD subsystem.

   You must call this function before calling any other DVD function

Returns: none

◆ DVD_Mount()

s32 DVD_Mount ( void )

Mounts the DVD drive.

   This is a synchronous version of DVD_MountAsync().

Returns: none

◆ DVD_MountAsync()

s32 DVD_MountAsync	(	dvdcmdblk *	block,
		dvdcbcallback	cb
	)

Mounts the DVD drive.

   You <b>must</b> call this function in order to access the DVD.

   Following tasks are performed:
 - Issue a hard reset to the drive.
 - Turn on drive's debug mode.
 - Patch drive's FW.
 - Enable extensions.
 - Read disc ID

   The patch code and procedure was taken from the gc-linux DVD device driver.

Parameters

[in]	block	pointer to a dvdcmdblk structure used to process the operation
[in]	cb	callback to be invoked upon completion of operation

Returns: none

◆ DVD_Reset()

void DVD_Reset ( u32 reset_mode )

Performs a reset of the drive and FW respectively.

Parameters

[in] reset_mode type of reset

Returns: none

Data Structures

Macros

Typedefs

Functions

Variables

Detailed Description

Typedef Documentation

◆ dvdcallback

◆ dvdcmdblk

◆ dvddiskid

◆ dvddrvinfo

◆ dvdfileinfo

Function Documentation

◆ DVD_ControlDrive()

◆ DVD_ControlDriveAsync()

◆ DVD_Init()

◆ DVD_Mount()

◆ DVD_MountAsync()

◆ DVD_Reset()