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] [Next]