ILTDVDBurner::put_VolumeName

#include "ILTDVDBurner2.h"

C Syntax

HRESULT LTDVDBurner_put_VolumeName(pDVDBurner, newVal)

C++ Syntax

HRESULT put_VolumeName(newVal)

 

ILTDVDBurner *pDVDBurner;

/* pointer to an interface */

BSTR newVal;

/* volume name */

Sets the volume label of the disc to be burned.

Parameter

Description

pDVDBurner

Pointer to an ILTDVDBurner interface.

newVal

A character string that contains the volume label of the disc to be burned.

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

The currently selected drive must be in the idle state in order for this function to succeed.

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_VolumeName

Topics:

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

Example

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

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