DosQueryFSInfo - Parameters

disknum (ULONG) - input

Logical drive number for the disk about which information is to be retrieved.

This parameter can be any value from 0 through 26. If this parameter is zero, information about the disk in the current drive is retrieved. Otherwise, 1 specifies drive A, 2 specifies drive B, and so on.

When a logical drive is specified, the media in the drive is examined (for a local drive only), and the request is passed to the file system driver (FSD) responsible for managing that media, or to the FSD that is attached to the drive.

infolevel (ULONG) - input

Level of file information required.

Possible levels are described in the list below:

• FSIL_ALLOC Level 1 information

• FSIL_VOLSER
  Level 2 information

pBuf (PVOID) - output

Address of the storage area where the system returns the requested level of file information.

Level 1 Information

When a value of 1 (FSIL_ALLOC) is specified for infolevel, the information is returned in the format of an FSALLOCATE structure.
Level 2 Information
When a value of 2 (FSIL_VOLSER) is specified for infolevel, the information is returned in the format of an FSINFO structure.

cbBuf (ULONG) - input

The length, in bytes, of the buffer that receives the file-system information.

ulrc (APIRET) - returns

Return Code.

DosQueryFSInfo returns one of the following values:

• NO_ERROR 15
  ERROR_INVALID_DRIVE
  111
  ERROR_BUFFER_OVERFLOW
  124
  ERROR_INVALID_LEVEL
  125
  ERROR_NO_VOLUME_LABEL
  For a full list of error codes, see Errors.

---

[Back: DosQueryFSInfo Return Value - ulrc]
[Next: DosQueryFSInfo - Remarks]