savelij13
e400c8c902
- Added f_truncate(). - Added f_utime(). - Fixed off by one error at FAT sub-type determination. - Fixed btr in f_read() can be mistruncated. - Fixed cached sector is not flushed when create and close without write.
67 lines
2.4 KiB
HTML
67 lines
2.4 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<html lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
|
<meta http-equiv="Content-Style-Type" content="text/css">
|
|
<link rel="up" title="FatFs" href="../00index_e.html">
|
|
<link rel="stylesheet" href="../css_e.css" type="text/css" media="screen" title="ELM Default">
|
|
<title>FatFs - disk_ioctl</title>
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<div class="para">
|
|
<h2>disk_ioctl</h2>
|
|
<p>The disk_ioctl function cntrols device specified features and miscellaneous functions other than disk read/write.</p>
|
|
<pre>
|
|
DRESULT disk_ioctl (
|
|
BYTE <em>Drive</em>, /* Drive number */
|
|
BYTE <em>Command</em>, /* Control command code */
|
|
void* <em>Buffer</em> /* Data transfer buffer */
|
|
);
|
|
</pre>
|
|
</div>
|
|
|
|
<div class="para">
|
|
<h4>Parameters</h4>
|
|
<dl class="par">
|
|
<dt>Drive</dt>
|
|
<dd>Specifies the drive number (0-9).</dd>
|
|
<dt>Command</dt>
|
|
<dd>Specifies the command code.</dd>
|
|
<dt>Buffer</dt>
|
|
<dd>Pointer to the parameter buffer depends on the command code. When it is not used, specify a NULL pointer.</dd>
|
|
</dl>
|
|
</div>
|
|
|
|
|
|
<div class="para">
|
|
<h4>Return Value</h4>
|
|
<dl class="ret">
|
|
<dt>RES_OK (0)</dt>
|
|
<dd>The function succeeded.</dd>
|
|
<dt>RES_ERROR</dt>
|
|
<dd>Any error occured.</dd>
|
|
<dt>RES_PARERR</dt>
|
|
<dd>Invalid command code.</dd>
|
|
<dt>RES_NOTRDY</dt>
|
|
<dd>The disk drive has not been initialized.</dd>
|
|
</dl>
|
|
</div>
|
|
|
|
|
|
<div class="para">
|
|
<h4>Description</h4>
|
|
<p>The FatFs module uses only device independent commands described below. Any device dependent function is not used.</p>
|
|
<table class="lst">
|
|
<tr><th>Command</th><th>Description</td></tr>
|
|
<tr><td>CTRL_SYNC</td><td>Make sure that the disk drive has finished pending write process. When the disk I/O module has a write back cache, flush the dirty sector immediately. In read-only configuration, this command is not needed.</td></tr>
|
|
<tr><td>GET_SECTOR_COUNT</td><td>Returns total sectors on the drive into the DWORD variable pointed by Buffer. This command is used in only f_mkfs function.</td></tr>
|
|
<tr><td>GET_BLOCK_SIZE</td><td>Returns erase block size of the memory array in unit of sector into the DWORD variable pointed by Buffer. When the erase block size is unknown or magnetic disk device, return 1. This command is used in only f_mkfs function.</td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<p class="foot"><a href="../00index_e.html">Return</a></p>
|
|
</body>
|
|
</html>
|