Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

void  FSDev_Query (CPU_CHAR     *name_dev,

...

                   FS_DEV_INFO  *p_info,

...

                   FS_ERR       *p_err);

...

File

...

Called from

...

...

Code enabled by

...

fs_dev.c

...

Application

...

N/A

...

1092661Obtain information about a device.anchor11049831104983

Arguments

...

name_dev Anchor11414071141407

Device name.

Anchor10926641092664p_info Anchor11414141141414

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

Anchor11039601103960p_err Anchor11414211141421

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

...

classWebWorks_Indent_1

...

...

FS_ERR_NONE

...

...

Device information obtained.

...

classWebWorks_Indent_1

...

FS_ERR_NAME_NULL

...

...

Argument name_dev passed a NULL pointer.

...

classWebWorks_Indent_1

...

...

FS_ERR_NULL_PTR

...

...

Argument p_info passed a NULL pointer.

...

classWebWorks_Indent_1

...

FS_ERR_INVALID_SEC_NBR

...

...

classWebWorks_Indent_2

...

Sector start or count invalid.

...


Or device access error (see section B-4 “Device Error Codes”

...

).

...

...

Returned Value

Anchor10926731092673None. Anchor11003811100381

Notes/Warnings

...

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.