BP_OpenPartition (Windows CE 5.0)
This function opens or creates a partition.
HANDLE BP_OpenPartition(DWORD dwStartSector, DWORD dwNumSectors,DWORD dwPartType,BOOL fActive,DWORD dwCreationFlags);
Parameters
- dwStartSector
[in] Logical sector to the start of the partition. This value should be set to NEXT_FREE_LOC if no sector is specified. This parameter is ignored if an existing partition is opened. - dwNumSectors
[in] Number of logical sectors of the partition. This value can be set to USE_REMAINING_SPACE to indicate that the remaining space on the flash for the partition should be used. The USE_REMAINING_SPACE value should only be used when creating an extended partition. This parameter is ignored if an existing partition is opened. - dwPartType
[in] Type of partition to open or create. The following table shows the possible values for dwPartType.Value Description PART_BOOTSECTION Creates a boot section that can be used to store boot arguments. All flash blocks in the partition are marked as read-only. PART_BINFS Creates a BinFS partition. All flash blocks in the partition are marked as read-only. PART_EXTENDED Creates an extended partition that can be used to store one or more data partitions, such as FATFS. If dwStartSector is not on a block boundary then it is incremented to start at the next block boundary. - fActive
[in] Set to TRUE to indicate that the partition is active. Set to FALSE for inactive. - dwCreationFlags
[in] Value that stores information for opening or creating a partition. The following table shows the possible values for dwCreationFlags.Value Description PART_CREATE_NEW Creates a partition. Fails if a partition already exists. PART_OPEN_EXISTING Opens an existing partition. Fails if the partition does not exist. PART_OPEN_ALWAYS Creates a partition if it does not exist or opens a partition if it does exist.
Return Values
Returns a handle to the partition on success. Returns INVALID_HANDLE_VALUE on an error.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Bootpart.h
Link Library: Bootpart.lib
See Also
BinFS and the Bootpart Library | Flash Media Drivers
Send Feedback on this topic to the authors