ILTDVDBurner::TestWrite

#include "ILTDVDBurner2.h"

C Syntax

HRESULT LTDVDBurner_TestWrite(pDVDBurner)

C++ Syntax

HRESULT TestWrite()

 

ILTDVDBurner *pDVDBurner;

/* pointer to an interface */

Performs a writing test.

Parameter

Description

pDVDBurner

Pointer to an ILTDVDBurner interface.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

No data is written to the disc during the test. This function might be used to verify the image to be burned.

The write tests are not supported for media of type DVD+RW. Do not call this function when ILTDVDBurner::get_DiscType indicates the current disk is of type LTDVDBurner_DiscType_DVDPLUSRW.

Required DLLs and Libraries

LTDVDBRN
DSKernel

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

ILTDVDBurner::get_TestWriteable

Topics:

Video Streaming Function Groups, Multimedia Function Group, DVD Function Groups, How to use the DVD Burner to burn ISO  files and DVD images

Example

For a C example, refer to ILTDVDBurner::TestWrite Example for C.

For a C++ example, refer to ILTDVDBurner::TestWrite Example for C++.