osPfsSetLabel

#include <ultra64.h>
s32 osPfsSetLabel(OSPfs *pfs, u8 *label);

Explanation
A 32-byte label area is provided in the Controller Pak. The function osPfsSetLabel writes this label. As of December 1998, the specifications for the label had not been defined. Thus, this function should not yet be used.

The function writes data specified by label to the label area.

The OSPfs structure (pfs) is a file handle initialized by a call to osPfsInitPak. For information concerning the creation of this handle, see osPfsInitPak.

If the function is called successfully, a 0 value is returned. If an error occurs, one of the following error codes is returned:

• PFS_ERR_NOPACK - Some type of PIF error has occurred; either the Controller Pak is not inserted into the specified Controller or the Controller is not properly connected. To determine which is the case, use the osContStartQuery or osContGetQuery function.
• PFS_ERR_NEW_PACK - A different Controller Pak has been inserted. To use the inserted Controller Pak, initialize it by calling osPfsInitPak.
• PFS_ERR_CONTRFAIL - Data transfer to or from the Controller has failed. If a transfer error occurs, up to three tries will be done internally. Therefore, this error is rarely seen. If this error occurs, it is possible that either the Controller is not connected properly, or the Controller Pak or Controller Socket is damaged.

Revision History
2/1/1999 Revised entirely