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 (Multimedia toolkit)  or LTKRN (Imaging Pro, Document, or Medical toolkits)

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

Platforms

Win32, x64

See Also

Functions:

ILTDVDBurner::get_TestWriteable

Topics:

Video Streaming Function Groups, Multimedia Function Group, DVD Function Groups

Example

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

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