File | Called from | Code enabled by |
---|---|---|
| Application | N/A |
Obtain information about a device.
Arguments
name_dev
Device name.
p_info
Pointer to structure that will receive device information (see Note).
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
- For removable medias,
FSDev_Query()
will return a valid value for theState
andFixed
members ofp_info
even if the media is not present,Size
andSecSize
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 ofp_info
will be invalid.