Function

    nuContPakOpen

    Syntax:

    void nuContPakOpen(NUContPakFile *file, u32 cont_no)

    Arguments:

    file	Controller Pak file structure
    cont_no	Controller number to open

    Return Value:

    None

    Explanation:

Opens a Controller Pak device

Checks to see whether a Controller Pak or a Rumble Pak is inserted. If a Controller Pak is inserted, a file is initialized so it can be accessed by the Controller Pak.

When a Controller Pak is inserted, NU_CONT_PAK_TYPE_PAK is set in file.type. If nothing is inserted, NU_CONT_PAK_TYPE_NONE is set. This function can be used to determine which Controller(s) contain Controller Pak(s).

The value returned from the osPfsInitPak function or from the osMotorInit function is set in file.error. For details about the returned values, please see the explanation for each function.

    For example:
    	NUContPakFile pakFile;

    	// Register company code and game code
    	nuContPakCodeSet("64", "TEST");

    	// Open Controller Pak device
    	nuContPakOpen(&pakFile, 0);

    	if(!pakFile.error){
    		// Error processes for PFS_ERR_NOPACK, PFS_ERR_NEW_PACK,
    		// PFS_ERR_CONTRFAIL, PFS_ERR_ID_FATAL, PFS_ERR_DEVICE
    		......
    		return ERROR;
    	}

    	if(pakFile.type !=NU_CONT_PAK_TYPE_PAK){
    		// Process if not a Controller Pak
    		......
    		return ERROR;
    	}

    	// Open game note
    	nuContPakFileOpenJis(&pakFile, "NuSystemSaveData", "a", NU_CONT_PAK_CREATE, 256);

    	if(!pakFile.error){
    		// Error processes for PFS_ERR_INCONSISTENT, PFS_ERR_INVALID
    		// PFS_ERR_DATA_FULL, PFS_DIR_FULL
    		......
    		return ERROR;
    	}

    Reference: nuContPakFileOpen, nuContPakFileOpenJis

- Revision History

1999/2/1 Deleted text regarding Rumble Pak