disk_read

The disk_read function reads sector(s) from the disk drive.

DRESULT disk_read (
  BYTE Drive,          /* Physical drive number */
  BYTE* Buffer,        /* Pointer to the read data buffer */
  DWORD SectorNumber,  /* Start sector number */
  BYTE SectorCount     /* Number of sectros to read */
);

Parameters

Drive

Specifies the physical drive number.

Buffer

Pointer to the byte array to store the read data. The buffer size of number of bytes to be read is required. The start address specified by upper layer may be aligned or non-aligned.

SectorNumber

Specifies the start sector number in logical block address (LBA).

SectorCount

Specifies number of sectors to read. The value can be 1 to 255.

Return Value

RES_OK (0)

The function succeeded.

RES_ERROR

Any hard error occured during the read operation and could not recover it.

RES_PARERR

Invalid parameter.

RES_NOTRDY

The disk drive has not been initialized.