N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

   

nuContPakFileFind

Format
void nuContPakFileFind(NUContPakFile *file, u8* noteName, u8* extName)

Arguments
  • file is the pointer to the Controller Pak file structure
  • noteName is the pointer to the game note name (16 bytes in N64 font code)
  • extName is the note extension (1 byte in N64 font code)
Returned Value
none

What This Macro Does
It searches to see if the specified game note exists in the Controller Pak. If the game note is found, the note number is returned to file.file_no. If it cannot be found, PFS_INVALID is returned to file.error. The file argument must point to a location in a device that has been opened by the nuContPakOpen function.

Before calling this function, ensure that the company code and game code have been registered by the nuContPakCodeSet function.

If the game note name does not fill 16 bytes, 0x00 is assigned to the unused space. The size of the note extension is 4 bytes, but 1 byte is usable, and it is usually 0x00. Additional notes are assigned 0x1A-0x33 ('A'-'Z' in N64 font code) The value returned by the osPfsFileFind function is set in file.error. This function is a macro of the nuContPakFileOpen function.

See Also
nuContPakOpen
nuContPakFileOpen
nuContPakFileOpenJis
nuContPakFileFindJis



Nintendo® Confidential

Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.


Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated January 1998