Export (0) Print
Expand All

IBurnVerification interface

Use this interface with IDiscFormat2Data or IDiscFormat2TrackAtOnce to get or set the Burn Verification Level property which dictates how burned media is verified for integrity after the write operation.

Members

The IBurnVerification interface inherits from the IUnknown interface. IBurnVerification also has these types of members:

Methods

The IBurnVerification interface has these methods.

MethodDescription
get_BurnVerificationLevel

Retrieves the current Burn Verification Level.

put_BurnVerificationLevel

Sets the Burn Verification Level.

 

Remarks

The following example function demonstrates how the burn verification level defined by IMAPI_BURN_VERIFICATION_LEVEL, can be implemented. Burn verification level should be set prior to a burn operation.


#include <imapi2.h>

HRESULT setBurnVerification(
    IDiscFormat2Data                *DataWriter,
    IMAPI_BURN_VERIFICATION_LEVEL   VerificationLevel
    )

{
    HRESULT hr = S_OK;
    IBurnVerification *burnVerifier = NULL;
 
    hr = DataWriter->QueryInterface(IID_PPV_ARGS(&burnVerifier));
 
    if (SUCCEEDED(hr))
    {
        hr = burnVerifier->put_BurnVerificationLevel(VerificationLevel);
    }
 
    if (burnVerifier != NULL)
    {
        burnVerifier->Release();
        burnVerifier = NULL;
    }
 
    return hr;
}


This interface 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

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

IDL

Imapi2.idl

See also

IMAPI_BURN_VERIFICATION_LEVEL
IDiscFormat2Data
IDiscFormat2TrackAtOnce

 

 

Community Additions

ADD
Show:
© 2014 Microsoft