📄 dosfsfmtlib.html
字号:
<html><head><!-- /vobs/wpwr/docs/vxworks/ref/dosFsFmtLib.html - generated by refgen from dosFsFmtLib.c --> <title> dosFsFmtLib </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.htm"><i>VxWorks API Reference : OS Libraries</i></a></p></blockquote><h1>dosFsFmtLib</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>dosFsFmtLib</strong> - MS-DOS media-compatible file system formatting library </p></blockquote><h4>ROUTINES</h4><blockquote><p><p><b><a href="./dosFsFmtLib.html#dosFsVolFormat">dosFsVolFormat</a>( )</b> - format an MS-DOS compatible volume<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This module is a scaleable companion module for <b><a href="./dosFsLib.html#top">dosFsLib</a></b>, and is intended to facilitate high level formatting of disk volumes.<p>There are two ways to high level format a volume:<dl><dt>(1)<dd>Directly calling <b><a href="./dosFsFmtLib.html#dosFsVolFormat">dosFsVolFormat</a>( )</b> routine allows to have completecontrol over the format used, parameters and allows to supply a hookroutine which for instance could interactively prompt the user tomodify disk parameters.<dt>(2)<dd>Calling ioctl command FIODISKINIT will invoke the formatting routinevia <b><a href="./dosFsLib.html#top">dosFsLib</a></b>. This uses the default volume format and parameters.<br> </dl></blockquote><h4>AVAILABILITY</h4><blockquote><p><p>This routine is an optional part of the MS-DOS file system,and may be included in a target system if it is required tobe able to format new volumes.<p>In order to include this option, the following function needsto be invoked during system initialization:<pre>void dosFsFmtLibInit( void );</pre>See reference page <b><a href="./dosFsFmtLib.html#dosFsVolFormat">dosFsVolFormat</a>( )</b> for complete description ofsupported formats, options and arguments.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./dosFsLib.html#top">dosFsLib</a></b><hr><a name="dosFsVolFormat"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>dosFsVolFormat( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>dosFsVolFormat( )</strong> - format an MS-DOS compatible volume</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS dosFsVolFormat ( void * device, /* device name or volume or CBIO pointer */ int opt, /* bit-wise or'ed options */ FUNCPTR pPromptFunc /* interactive parameter change callback */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This utility routine performs the initialization of file system datastructures on a disk. It supports FAT12 for small disks, FAT16 formedium size and FAT32 for large volumes.The <i>device</i> argument may be either a device name known to the I/Osystem, or a <b><a href="./dosFsLib.html#top">dosFsLib</a></b> Volume descriptor or a CBIO device handle.<p>The <i>opt</i> argument is a bit-wise or'ed combination of options controlling theoperation of this routine as follows:<p><dl><dt><b>DOS_OPT_DEFAULT</b><dd>If the current volume boot block is reasonably intact, use existingparameters, else calculate parameters based only on disk size, possiblyreusing only the volume label and serial number.<p><dt><b>DOS_OPT_PRESERVE</b><dd>Attempt to preserve the current volume parameters even if they seem tobe somewhat unreliable.<p><dt><b>DOS_OPT_BLANK</b><dd>Disregard the current volume parameters, and calculate new parametersbased only on disk size.<p><dt><b>DOS_OPT_QUIET</b><dd>Do not produce any diagnostic output during formatting.<p><dt><b>DOS_OPT_FAT16</b><dd>Format the volume with FAT16 format even if the disk is larger then 2 Gbytes, which would normally be formatted with FAT32.<p><dt><b>DOS_OPT_FAT32</b><dd>Format the volume with FAT32, even if the disk is smaller then 2 Gbytes, but is larger then 512 Mbytes.<p><dt><b>DOS_OPT_VXLONGNAMES</b><dd>Format the volume to use Wind River proprietary case-sensitive LongFile Names. Note that this format is incompatible with any otherimplementation of the MS-DOS file system.<p></dl>The third argument, <i>pPromptFunc</i> is an optional pointer to a functionthat may interactively prompt the user to change any of themodifiable volume parameters before formatting:<p><pre>void formatPromptFunc( DOS_VOL_CONFIG *pConfig );</pre>The <*pConfig> structure upon entry to <b>formatPromptFunc( )</b> will containthe initial volume parameters, some of which can be changed before itreturns. <i>pPromptFunc</i> should be NULL if no interactive prompting isrequired.<p></blockquote><h4>COMPATIBILITY</h4><blockquote><p><p>Although this routine tries to format the disk to becompatibile with Microsoft implementations of the FAT and FAT32file systems, there may be differences which are not under WRScontrol. For this reason, it is highly recommended that anydisks which are expected to be interchanged between vxWorks andWindows should be formatted under Windows to provide the bestinterchangeability. The WRS implementation is more flexible,and should be able to handle the differences when formatting isdone on Windows, but Windows implementations may not be able tohandle minor differences between their implementation and ours.<p></blockquote><h4>AVAILABILITY</h4><blockquote><p>This function is an optional part of the MS-DOS file system,and may be included in a target system if it is required tobe able to format new volumes.<p></blockquote><h4>RETURNS</h4><blockquote><p>OK or ERROR if was unable to format the disk.</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./dosFsFmtLib.html#top">dosFsFmtLib</a></b></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -