BP_LowLevelFormat
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This function erases, verifies, and writes logical sectors in a specified range. This function should be called when preparing Flash memory for a download of multiple .bin files.
Syntax
BOOL BP_LowLevelFormat(
DWORD dwStartBlock,
DWORD dwNumBlocks,
DWORD dwFlags
);
Parameters
- dwStartBlock
[in] Starting physical block to format.
- dwNumBlocks
[in] Number of physical blocks to format
dwFlags
[in] Format settings. The following table shows possible values.Value Description FORMAT_SKIP_BLOCK_CHECK
Skips a read/write verification to check for bad blocks. This is recommended for NOR flash.
FORMAT_SKIP_RESERVED
Reserved blocks are not erased.
Return Value
TRUE indicates success. FALSE indicates failure.
Remarks
The logical sector zero is assigned to the first sector in the first good block starting from dwStartBlock and a mater boot record (MBR) is written to logical sector zero. The function erases dwNumBlocks number of blocks, skipping bad blocks in all cases and reserved blocks if specified in dwFlags. Bad blocks and reserved blocks count against the dwNumBlocks specified value.
Requirements
| Header | bootpart.h |
| Library | Bootpart.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |
See Also
Reference
Concepts
BinFS and the Bootpart Library