mfsHGetVolumeAttr

Syntax

s32 mfsHGetVolumeAttr(s32 drive)

Arguments

drive   Drive name ('A', 'B', ...)
Return value
Volume attribute (a negative value is an error)

Function

Obtains volume attribute

Description

This function obtains and returns the volume attribute of the drive specified by drive. The volume attribute, which is represented by u8-type bits, can have the following contents.

MFS_VOLUME_ATTR_VPROTECT_WRITE 0x20 Volume write protected
MFS_VOLUME_ATTR_VPROTECT_READ 0x40 Volume read protected
MFS_VOLUME_ATTR_WPROTECT 0x80 Write protected

When the MFS_VOLUME_ATTR_VPROTECT_WRITE bit is 1, it indicates that the disk is write protected from other games. The disk can be written to only when the company code and game code specified by the mfsHInit*Boot() or mfsSetGameCode() function match the company code and game code written in the system ID area of the disk.

When the MFS_VOLUME_ATTR_VPROTECT_READ bit is 1, it indicates that the disk is read protected from other games. The disk can be read from only when the company code and game code specified by the mfsHInit*Boot() or mfsSetGameCode() function match the company code and game code written in the system ID area of the disk.

When MFS_VOLUME_ATTR_WPROTECT is specified, the disk is write protected from all games.

Main errors

MFS_ERR_NOTFOUND Drive not found