Differences

This shows you the differences between two versions of the page.

--- en:docs:fapi:dosqfsinfo [2021/08/29 15:27] – prokushev
+++ en:docs:fapi:dosqfsinfo [2021/09/17 08:11] (current) – prokushev
@@ Line 5: / Line 5: @@
 This call queries information from a file system device.
-==Syntax==
+===== Syntax =====
- DosQFSInfo (DriveNumber, FSInfoLevel, FSInfoBuf, FSInfoBufSize)
+<code c>
+DosQFSInfo (DriveNumber, FSInfoLevel, FSInfoBuf, FSInfoBufSize)
+</code>
-==Parameters==
+===== Parameters =====
-  * DriveNumber (USHORT) - input : Logical drive number (0 = default, 1 = A, and so on).
-:When a logical drive is specified, the media in the drive is examined (local drive only) and the request is passed to the FSD responsible for managing that media or to the FSD that is attached to the drive.
-  * ;FSInfoLevel (USHORT) - input : Level of file information required.
-  * ;FSInfoBuf (PBYTE) - output : Address of the storage area where the system returns the requested level of file information.
-:Level 1 Information
+  * DriveNumber ([[USHORT]]) - input : Logical drive number (0 = default, 1 = A, and so on).
-:For FSInfoLevel = 1, information is returned in the following structure:
-  *::filesysid (ULONG) - File system ID.
+When a logical drive is specified, the media in the drive is examined (local drive only) and the request is passed to the FSD responsible for managing that media or to the FSD that is attached to the drive.
-  *::sectornum (ULONG) - Number of sectors per allocation unit.
-  *::unitnum (ULONG) -  Number of allocation units.
+  * FSInfoLevel ([[USHORT]]) - input : Level of file information required.
-  *::unitavail (ULONG) - Number of allocation units available.
+  * FSInfoBuf ([[PBYTE]]) - output : Address of the storage area where the system returns the requested level of file information.
-  *::bytesnum (USHORT) - Number of bytes per sector.
+  * FSInfoBufSize ([[USHORT]]) : Length of the buffer.
-:Level 2 Information
-:For FSInfoLevel = 2, the information is returned in the following format:
+==== Level 1 Information ====
-  *::reserved (ULONG) - Reserved
-  *::volumelength (BYTE) - Length of the volume label, not including the null.
+For FSInfoLevel = 1, information is returned in the following structure:
-  *::volumelabel (CHAR) - Volume label ASCIIZ string.
-  *;FSInfoBufSize (USHORT) : Length of the buffer.
+  *filesysid ([[ULONG]]) - File system ID.
+  *sectornum ([[ULONG]]) - Number of sectors per allocation unit.
+  *unitnum ([[ULONG]]) -  Number of allocation units.
+  *unitavail ([[ULONG]]) - Number of allocation units available.
+  *bytesnum ([[USHORT]]) - Number of bytes per sector.
+==== Level 2 Information ====
+For FSInfoLevel = 2, the information is returned in the following format:
+  *reserved ([[ULONG]]) - Reserved
+  *volumelength ([[BYTE]]) - Length of the volume label, not including the null.
+  *volumelabel ([[CHAR]]) - Volume label ASCIIZ string.
+===== Return Code =====
+rc ([[USHORT]]) - return
-==Return Code==
- rc (USHORT) - return
 Return code descriptions are:
   * 0          NO_ERROR
@@ Line 38: / Line 50: @@
   * 125        ERROR_NO_VOLUME_LABEL
-==Remarks==
+===== Remarks =====
 Trailing blanks supplied at volume label definition time are not considered to be part of the label and are therefore not returned as valid label data. Volume label is limited to a length of 11 bytes.
@@ Line 45: / Line 58: @@
 If there is no volume serial number on the disk/diskette, the volume serial number information is returned as binary zeros. If there is no volume label on the disk/diskette, the volume label information is returned as blank spaces. If there is no volume serial number and/or volume label for disk/diskette volumes formatted by DOS 3.X, this information is not displayed by the Hard Error Handler.
-==Example Code==
+===== Example Code =====
-===C Binding===
-<PRE>
+==== C Binding ====
+<code c>
 typedef struct _FSALLOCATE {
     ULONG  idFileSystem;  /* file system ID */
@@ Line 93: / Line 108: @@
 USHORT           rc;            /* return code */
-</PRE>
+</code>
+==== MASM Binding ====
-===MASM Binding===
 <code asm>
@@ Line 114: / Line 130: @@
 PUSH   WORD    FSInfoBufSize ;File system info buffer size
 CALL   DosQFSInfo
+</code>
 Returns WORD
+===== Note =====
-</code>
-====== Note ======
 Text based on http://www.edm2.com/index.php/DosQFSInfo