DVDCommandBlock

C Specification

#include <revolution/dvd.h>

typedef struct DVDCommandBlock DVDCommandBlock;

struct DVDCommandBlock
{
    ............
    void*      userData;
};

(All structure members are not listed. For a complete list, look at dvd.h. Do not directly access these members. They're subject to change.) Please use the DVDGetUserData and DVDSetUserDatafunction to access the userData structure member.)

Description

The DVDCommandBlock structure is used for the DVD library to manage certain data. One type is queue management. All DVD commands can be entered in a queue (waiting for previous requests to complete is unnecessary). This queue feature is implemented by chaining DVDCommandBlock structures. For this reason, If a DVDCommandBlock structure is in use, another DVD request that uses this structure can't be issued.

If a DVD request using a DVDCommandBlock structure completes, this DVDCommandBlock structure can be used. The structure can be used in the callback function for the request that used the structure. Because the DVD library ended the request when the callback function was called, the structure is no longer needed.

See Also

DVDFileInfo
DVDGetUserData
DVDSetUserData

Revision History

03/01/2006 Initial version.