FSDev_Query()

void  FSDev_Query (CPU_CHAR     *name_dev,
                   FS_DEV_INFO  *p_info,
                   FS_ERR       *p_err);

Obtain information about a device.

Arguments

name_dev

Device name.

p_info

Pointer to structure that will receive device information (see Note #1).

p_err

Pointer to variable that will receive the return error code from this function:

FS_ERR_NONE

Device information obtained.

FS_ERR_NAME_NULL

Argument name_dev passed a NULL pointer.

FS_ERR_NULL_PTR

Argument p_info passed a NULL pointer.

FS_ERR_INVALID_SEC_NBR

Sector start or count invalid.

Or device access error (see µC/FS Error Codes).

Returned Value

None.

Notes/Warnings

1. For removable medias, FSDev_Query() will return a valid value for the State and Fixed members of p_info even if the media is not present, Size and SecSize will be set to 0. In such cases an error will be returned stating the reason why the device was unaccessible. Otherwise, if a fatal error occurs or the device is not opened an appropriate error will be return and the content of p_info will be invalid.