osCratRomInit osCartRomInit (function)

Returns information regarding the hardware settings necessary when using a cartridge

Syntax

#include <ultra64.h>     /* ultra64.h */
OSPiHandle *osCartRomInit(void)

Description

osCartRomInit returns information regarding the hardware settings necessary when using a cartridge. Specifically, it returns

  1. the PI domain it belongs to
  2. PI bus settings

For details, please see osEPiStartDma, osEPiStartDma.

OSPiHandle is a global data structural unit returned by this routine. It functions as a handle to be referenced by the EPI (expanded peripheral interface) routine. When the osEPi(Raw) function is used for the ROM Emulator, the OSPiHandle structural unit to be used is determined by the value returned by the osCartRomInit function.

Note

The EPI routine actually does the bus Initialization. This function (osCartRomInit) just returns information needed for initialization in a structure.

See Also

osEPiRawStartDma, osEPiStartDma

Revision History

1999/04/30 Changed Format