Функция disk_ioctl управляет специальными функциями диска и его различными особенностями, не относящимися к чтению/записи диска.

DRESULT disk_ioctl (
  BYTE Drive,      /* Номер привода */
  BYTE Command,    /* Код команды управления */
  void* Buffer     /* Параметр и буфер данных */
);

Параметры

Drive

Указывает номер привода (0-9).

Command

Указывает код команды.

Buffer

Указатель на буфер, в котором может содержаться параметр или данные - в зависимости от кода команды. Когда не используется, то указатель Buffer равен NULL.

Возвращаемые значения

RES_OK (0)

Функция завершилась успешно.

RES_ERROR

Произошла какая-то ошибка.

RES_PARERR

Недопустимый код команды.

RES_NOTRDY

Привод диска не был инициализирован.

Описание

Модуль FatFs использует только независимые от устройства команды, которые перечислены в таблице ниже. Не используются никакие функции, которые зависят от устройства.

Command	Description
CTRL_SYNC	Обеспечивает завершение приводом диска операций, ожидающих завершения процесса записи. Когда модуль disk I/O имеет write back cache, то кэш сектора немедленно сбрасывается на диск. Эта команда не используется в конфигурации только чтение (read-only).
GET_SECTOR_SIZE	Возвращает размер сектора привода в переменной типа WORD, на которую указывает Buffer. Эта команда не используется в конфигурации с фиксированным размером сектора, _MAX_SS равно 512.
GET_SECTOR_COUNT	Возвращает количество доступных секторов на приводе в переменной типа DWORD, на которую указывает Buffer. Эта команда используется только функцией f_mkfs для определения размера создаваемого тома.
GET_BLOCK_SIZE	Возвращает размер блока для очистки (erase block size) в единицах секторов в переменной типа DWORD, на которую указывает Buffer. Допустимые значения от 1 до 32768, число должно быть равно степени числа 2. Возвращаемое значение 1 означает, что размер блока для очистки (erase block size) неизвестен, либо это не flash, а дисковое устройство. Эта команда используется только функцией f_mkfs, чтобы она сделала попытку выровнять область данных на границу очищаемого блока.
CTRL_ERASE_SECTOR	Очищает (erase) часть памяти flash, заданную массивом DWORD array { , }, на который указывает Buffer. Когда эта возможность не поддерживается, или это не физический носитель flash memory, то эта команда не дает никого эффекта. Библиотека FatFs не делает проверку кода возврата, и на файловые функции не оказывает никакого влияния тот факт, что секторы не были почему-то успешно очищены. Эта команда вызывается при удалении кластерной цепочки, когда задана опция _USE_ERASE, равная 1.