CmEmbedded_4c_transp CmExtendedDiscControl

Description

CmExtendedDiscControl is used to obtain information of a Secure Disk partition of a CmContainer.

information_weiss_klein26

For more details on the Secure Disk feature, please contact Wibu-Systems support.
  • C, C++
  • C#

Syntax

int CMAPIENTRY CmExtendedDiscControl(HCMSysEntry hcmse, CMULONG flCtrl, const CMBYTE *data, CMUINT cbData);

Parameter

hcmse contains a handle opened by CmAccess2 (can be Box Access, Entry Access or Firm Item access).

flCtrl contains the flags available for obtaining information of a secure disk partition.

nav_open CM_SECURE_DISC_STATUS contains information on the secure disc status (0x00000200).

nav_open CM_GET_DISC_CONFIGURATION contains information of the disk configuration (0x00000203).

data points to the structures:

hmtoggle_plus1 CM_DISC_STATUS.

Structure CM_DISC_STATUS

CM_DISC_STATUS contains information on the secure disk partition.

Syntax

typedef struct __CM_DISC_STATUS {

 CMULONG mulErrorCode;

 CMULONG mulEnablingBits;

 CMULONG mulDiscSectorsTotal;

 CMULONG mulWriteOnceCount;

 CMBYTE  mabReserved[64];

} CM_DISC_STATUS;

Parameter

mulErrorCode contains the error code after a read or write operation.

mulEnablingBits contains the enabling bits set for the Secure Disk partition.

mulDiscSectorsTotal contains the total number of sectors (each 512 byte).

mulWriteOnceCount contains the number of the block following a block which is one-time written.

mabReserved[64] is reserved for future purpose.

 

hmtoggle_plus1 CM_DISC_CONFIGURATION)

Structure CM_DISC_CONFIGURATION

CM_DISC_CONFIGURATION contains information of the disk configuration.

Syntax

typedef struct __CM_DISC_CONFIGURATION {

 CMBYTE mbMajorFirmwareRevision;

 CMBYTE mbMinorFirmwareRevision;

 CMUSHORT musBytesPerSector;

 CMULONG mulLengthOfBlock0;

 CMULONG mulLengthOfBlock1;

 CMULONG mulLengthOfBlock2;

 CMULONG mulLengthOfBlock3;

 

 CMULONG mulFlashSize;

 CMULONG mulSerialNumber;

 CMULONG mulEnablingStatus;

 

 CMBYTE[12] mabReserved;

 

} CM_DISC_CONFIGURATION;

 

Parameter

mbMajorFirmwareRevision contains major Firmware version number of the flash controller, e.g. 9.

mbMinorFirmwareRevision contains the minor Firmware version number of the flash controller, e.g. 3.

musBytesPerSector contains the fixed size of the sector. Currently 512.

mulLengthOfBlock0 contains block length of public disk.

mulLengthOfBlock1 contains block length of private disk.

mulLengthOfBlock2 contains block length of cd-rom disk.

mulLengthOfBlock3 contains block length of secure disk.

mulFlashSize contains size of flash memory.

mulSerialNumber contains CodeMeter chip serial number without mask code.

mulEnablingStatus contains the various enabling stati in the IFI (Implicit Firm Item).

mabReserved is reserved for future purpose.

mulArticleMinor contains.

mulArticleSubcase contains.

 

cbData contains the length of data in bytes.

 

Return

If the functions fails, a value of 0 is returned.

Notes