www.beck-ipc.com

@CHIP-RTOS C Library - BIOS API


BIOS_Disk_Space

Report number of free bytes on specified disk drive.

unsigned long BIOS_Disk_Space (unsigned int drive );

Parameters

drive

Drive index:
    0 = current drive
    1 = A: drive
    2 = B: drive
    ... and so on.

Return Value

Available disk space, number of bytes free.   This value will be zero if the drive number specified was invalid.

Comments

This function applies to drives with under 4 Giga-bytes of disk space.   For drives larger than 4 Giga-bytes, the free disk space may exceed the capacity of this API's 32 bit return value, resulting in a garbage result.

This API will be required for drives which exceed the DOS interrupt 0x21 service 0x36 API's reporting capacity of 0xFFFF clusters maximum.

See Also

RTOS API

This library function invokes a RTOS software interrupt.   Refer to this RTOS API function's documentation for more details.

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3SC2x
    V1.23V1.23V1.23V1.16V1.00

Supported by @CHIP-RTOS C Library since version

    CLIB
    V2.11

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document