X-Git-Url: http://cloudbase.mooo.com/gitweb/z180-stamp.git/blobdiff_plain/70702af1370e44e32fb2c3c507e4759a187b4fe5..289f6a146c0b2087607d8d8659531ea90142779a:/fatfs/doc/en/getlabel.html diff --git a/fatfs/doc/en/getlabel.html b/fatfs/doc/en/getlabel.html deleted file mode 100644 index cec65aa..0000000 --- a/fatfs/doc/en/getlabel.html +++ /dev/null @@ -1,82 +0,0 @@ - - - - - - - - -FatFs - f_getlabel - - - - -
-

f_getlabel

-

The f_getlabel function returns volume label and volume serial number of a drive.

-
-FRESULT f_getlabel (
-  const TCHAR* path,  /* [IN] Drive number */
-  TCHAR* label,       /* [OUT] Volume label */
-  DWORD* vsn          /* [OUT] Volume serial number */
-);
-
-
- -
-

Parameters

-
-
path
-
Pointer to the null-terminated string that specifies the logical drive. Null-string specifies the default drive.
-
label
-
Pointer to the buffer to store the volume label. The buffer size must be at least 24 items at _LFN_UNICODE == 0 or 12 items at _LFN_UNICODE == 1. If the volume has no label, a null-string will be returned. Set null pointer if this information is not needed.
-
vsn
-
Pointer to the DWORD variable to store the volume serial number. Set null pointer if this information is not needed.
-
-
- - -
-

Return Values

-

-FR_OK, -FR_DISK_ERR, -FR_INT_ERR, -FR_NOT_READY, -FR_INVALID_DRIVE, -FR_NOT_ENABLED, -FR_NO_FILESYSTEM, -FR_TIMEOUT -

-
- - -
-

QuickInfo

-

Available when _USE_LABEL == 1.

-
- - -
-

Example

-
-    char str[24];
-
-    /* Get volume label of the default drive */
-    f_getlabel("", str, 0);
-
-    /* Get volume label of the drive 2 */
-    f_getlabel("2:", str, 0);
-
-
- - -
-

See Also

-f_setlabel -
- - -

Return

- -