This is a code sample to give you an idea how to incorporate a Format function to your solution. The Format functionality helps you select the right file system format for a new partition, or change the file system format of an existing volume. NTFS and FAT file system formats are supported.

Due to internal restrictions, hdmengine cannot work on multiple processes at the same time, so it locks the volume during the process to restrict access from another process. For example, if an additional process is initialized (for example, resize a partition) when the hdmengine is busy with a different process (for example, creating a partition), the engine will not be able to lock the additional process (resize a partition) and will execute it in the Bluescreen mode.

Before you read the code sample:

  • Include the header files.
  • Add hdmclient_hdmclientlib.dll library to your project.
  • Set up callbacks from hdmclientlib.

For more details on the initial setup, please see the Setting Up the C++ Development Environment section.

Add the header files to copy blocks of memory and pull in the rest of the headers from the clientapp engine, including the callback prototypes.

#include <string.h> // memcpy
 
#include "../hdmclientapp_progress.h"

Set callbacks. You need to implement the abstract interface struct Hdmclient_IProgress.

_Hdmclient_Init                proc_Hdmclient_Init                = NULL;
_Hdmclient_Close               proc_Hdmclient_Close               = NULL;
_Hdmclient_GetInterface        proc_Hdmclient_GetInterface        = NULL;
_Hdmclient_GetLog              proc_Hdmclient_GetLog              = NULL;
_Hdmclient_InstallBluescreen   proc_Hdmclient_InstallBluescreen   = NULL;
_Hdmclient_GetErrorDescription proc_Hdmclient_GetErrorDescription = NULL;

Add a helper function to log output messages. How to set LogPrint please see hdmclientapp_main.cpp or look at a code sample here.

static void LogPrint(Hdmclient_ILog * /* pLog */, bool /* rewrite */, const char * /* format */, IN ...)
{
}

Set the disk number and partition number, you want to format, then select a new partition file system type, a new partition label, and a new partition cluster size (in sectors, i.e. 1,2,4,8…).

HDMCLIENT_ERR Hdmclient_Example_PartitionFormat(unsigned    diskNumber,         
                                                unsigned    partNumber,          
                                                PartitionFsType fsType, 
                                                const char     *pLabel,
                                                unsigned clusterSizeSectors)
{
    HDMCLIENT_ERR err = SERR_SUCCESS;
 
    BOOL bReboot = FALSE;
 
    Hdmclient_ILog *pLog = NULL;
 
    Hdmclient_Progress hdmclientProgress;

Set the hdmengine initialization flags and enable run multiple instances of Hdmengine application.

    if(!err)
    {
        unsigned int initFlags = Hdmclient_InitFlags::Hdmclient_InitFlag_EnableRunMultiple;

Initialize Hdmengine API: pass engine flags, pass the progress interface to Hdmengine API, pass the application log path. Then get the logging interface.

        err = proc_Hdmclient_Init((Hdmclient_InitFlags)initFlags,
                                 &hdmclientProgress,           
                                 "hdmclient_hdmclientapp.log",
                                 NULL, NULL, NULL);
 
       if(!err)
           proc_Hdmclient_GetLog(&pLog);
    }

Get the partitioning interface.

    if(!err)
    {
        Hdmclient_IInterface* pInterface = NULL;
        if(!err)
            err = proc_Hdmclient_GetInterface(&pInterface);

Search for the selected partition by disk and partition number (all numbers zero based, extended and free partitions are also counted)  Hdmclient_IInterface::DiskInfo diskInfo = {}; – Displays selected disk info and Hdmclient_IInterface::PartitionInfo partInfo displayed selected partition info:

          Hdmclient_IInterface::DiskInfo      diskInfo = {};
          Hdmclient_IInterface::PartitionInfo partInfo = {};

          if(!err)
          {
              Hdmclient_IInterface::EnumDisksInfo* enumDisksInfo = NULL;

Get the disks enumerator and release the disks enumerator.

              err = pInterface->GetDisksInfo(&enumDisksInfo);
              if(!err)
              {
                  if(enumDisksInfo && (enumDisksInfo->disksCount > 0))
                  {
                      if(!err)
                      {
                          if(diskNumber == (unsigned)-1)
                          {
                             err = SERR_DISK_NOT_FOUND;
 
                             LogPrint(pLog, false, "Disk is not selected .. Failed\n");
                          }else
                          if((diskNumber + 1) > enumDisksInfo->disksCount)
                          {
                              err = SERR_DISK_NOT_FOUND;
 
                              LogPrint(pLog, false, "Disk number is out of range (maximum number is %lu) .. Failed\n", enumDisksInfo->disksCount - 1);
                          }else
                          {
                              auto pDiskInfo = enumDisksInfo->ppDisksInfo[diskNumber];
 
                              memcpy(&diskInfo, pDiskInfo, sizeof(diskInfo));
 
                              if(partNumber != (unsigned)-1)
                              {
                                  if((partNumber + 1) <= pDiskInfo->enumPartitionsInfo.partitionsCount)
                                  {
                                      auto pPartitionInfo = pDiskInfo->enumPartitionsInfo.ppPartitionsInfo[partNumber];
 
                                      memcpy(&partInfo, pPartitionInfo, sizeof(partInfo));
                                  }else
                                  {
                                     err = SERR_PART_NOT_FOUND;
 
                                     LogPrint(pLog, false, "Partition number is out of range (maximum number is %lu) .. Failed\n", pDiskInfo->enumPartitionsInfo.partitionsCount - 1);
                                  }
                              }
                          }
                      }
                  }
 
                pInterface->ReleaseDisksInfo(enumDisksInfo);
            }
        }

Perform the virtual step. Check that the required action is available for selected object.

        if(!err)
        {
            if(!(partInfo.ActFlags & Hdmclient_IInterface::PartitionActFlags::PartitionActFlag_Can_Format))
            {
                err = SERR_INCOMPATIBLEOP;
 
                LogPrint(pLog, false, "Format is not enabled for selected partition ... Failed\n");
            }else

Check if the selected format is available for the selected object.

            {      
               if(fsType == PartitionFsType::PartitionFsType_Fat16)
               {
                   if(!(partInfo.FsTypeMaskFormat & Hdmclient_IInterface::PartitionFsTypeMask::PartitionFsTypeMask_Fat16))
                   {
                       err = SERR_INCOMPATIBLEOP;
 
                       LogPrint(pLog, false, "Format to Fat16 is not enabled for selected partition ... Failed\n");
                   }
               }else
               if(fsType == PartitionFsType::PartitionFsType_Fat32)
               {
                   if(!(partInfo.FsTypeMaskFormat & Hdmclient_IInterface::PartitionFsTypeMask::PartitionFsTypeMask_Fat32))
                   {
                       err = SERR_INCOMPATIBLEOP;
 
                       LogPrint(pLog, false, "Format to Fat32 is not enabled for selected partition ... Failed\n");
                   }
               }else
               if(fsType == PartitionFsType::PartitionFsType_Ntfs)
               {
                   if(!(partInfo.FsTypeMaskFormat & Hdmclient_IInterface::PartitionFsTypeMask::PartitionFsTypeMask_Ntfs))
                   {
                       err = SERR_INCOMPATIBLEOP;
 
                       LogPrint(pLog, false, "Format to Ntfs is not enabled for selected partition ... Failed\n");
                   }
               }else
               {
                   err = SERR_INCOMPATIBLEOP;
 
                   LogPrint(pLog, false, "Format to selected fs is not enabled for selected partition ... Failed\n");
               }

Perform the format action and log the action.

               if(!err)
               {
                   err = pInterface->Partition_Format(partInfo.DiskNumber,
                                                      partInfo.PartitionNumber,
                                                      fsType,
                                                      (const BYTE*)pLabel,
                                                      clusterSizeSectors);
 
                   LogPrint(pLog, false, "Formatting selected partition ... %s\n", err ? "Failed" : "Success");
               }
           }
       }

Perform the format (physical step): Apply the queue or above operations.

       if(!err)
       {
           if(!err)
           {
               LogPrint(pLog, false, "Applying operations ...\n");
 
               err = pInterface->Apply();
 
               if(!err)
               {
                   LogPrint(pLog, false, "Applying queue of operations ... Success\n");
               }else
               {
                    LogPrint(pLog, false, "Applying queue of operations ... Failed (Result: 0x%x, \"%s\")\n", err, proc_Hdmclient_GetErrorDescription(err));
               }
            }
        }
    }

Close the HDM client API.

   proc_Hdmclient_Close(bReboot, FALSE);

    return err;
}

If you have found a spelling error, please, notify us by selecting that text and pressing Ctrl+Enter.