NTAGSetFormatSettings

Syntax

#include <cafe/ntag.h>

// Format version.
enum {
    NTAG_FORMAT_VERSION_0 = 0,
    NTAG_FORMAT_VERSION_NUM,
};

typedef struct // Format settings.
{
    u8   formatVersion ;    // Format version.
    u32  makerCode ;        // Company code.
    u8   reserved[32];
} NTAGFormatSettings ;

void NTAGSetFormatSettings ( const NTAGFormatSettings* formatSettings );

Parameters

formatSettings Format settings.
  • Format version.
  • Maker code.

Return Values

None.

Description

Sets information necessary for reading and writing tags in Nintendo's proprietary format. Reading from and writing to tags fails if the values are not consistent with the values set with the NOFT mastering tool. Set a Nintendo-specified code for the company code. Set the format version to the same version as the NOFT mastering tool.

This function must be called once when using the NTAG library. After the information is set, as long as it is not overwritten by calling this function again, it is also available when calling NTAGInit and NTAGShutdown.

Do Not Call From

Background Do not call this function from the background.
Multiple threads This function is not thread-safe.
Multiple Cores Do not call this function from more than one Core.

Revision History

2013-05-08 Automated cleanup pass.
2013-01-31 Added a description.
2012-12-26 Initial version.


CONFIDENTIAL