Edit

IMAPI_BURN_VERIFICATION_LEVEL enumeration (imapi2.h)

  • Article

Defines values for the burn verification implemented by the IBurnVerification interface.

Syntax

typedef enum _IMAPI_BURN_VERIFICATION_LEVEL {
  IMAPI_BURN_VERIFICATION_NONE = 0,
  IMAPI_BURN_VERIFICATION_QUICK = 1,
  IMAPI_BURN_VERIFICATION_FULL = 2
} IMAPI_BURN_VERIFICATION_LEVEL, *PIMAPI_BURN_VERIFICATION_LEVEL;

Constants

 
IMAPI_BURN_VERIFICATION_NONE
Value: 0
No burn verification.
IMAPI_BURN_VERIFICATION_QUICK
Value: 1
A quick, heuristic burn verification.
IMAPI_BURN_VERIFICATION_FULL
Value: 2
This verification compares the checksum to the referenced stream for either the last session or each track. A full verification includes the heuristic checks of a quick verification for both burn formats.

Remarks

Depending on the format used for the burned media, the values defined by this enumeration will elicit the following behavior during verification:

MsftDiscFormat2Data
None No burn verification.
Quick Verification
  • READ_DISC_INFO command works and data appears correct
  • READ_TRACK_INFO command works on all tracks
  • Checksum comparison of a small set of disc sectors to stream bits
Full Verification
  • Performs the same heuristic checks as the 'Quick' method, but will also read the entire last session and compare a checksum to the burned stream.
 
MsftDiscFormat2TrackAtOnce
None No burn verification.
Quick Verification After adding each track:
  • READ_TRACK_INFO command for last track appears correct
When finishing the disc:
  • READ_DISC_INFO command appears correct
  • TOC appears correct
Full Verification Full verification is not supported with this format.
 

The time required for a full verification is relative to the read speed of the device and storage medium.

This enumeration is supported in Windows Server 2003 with Service Pack 1 (SP1), Windows XP with Service Pack 2 (SP2), and Windows Vista via the Windows Feature Pack for Storage. All features provided by this update package are supported natively in Windows 7 and Windows Server 2008 R2.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header imapi2.h

See also

IBurnVerfication