ILTDVDBurner::GetDriveName

Summary

Retrieves the name of the specified drive.

Syntax

Parameters

ILTDVDBurner *pDVDBurner

Pointer to an ILTDVDBurner interface.

long Index

Value that represents a zero-based index of the drive for which to retrieve its name.

BSTR *pVal

Pointer to a character string to be updated with the drive's name.

Returns

Comments

The retrieved name can be changed by the system: it is not suitable for drive identification. For more information, refer to the Microsoft documentation for system File/Volume API functions at https://learn.microsoft.com/en-us/windows/win32/fileio/volume-management-functions.

If the function succeeds, the user is responsible for freeing the retrieved drive name string by calling SysFreeString.

Required DLLs and Libraries

• LTDVDBrn
• DSKernel (Multimedia toolkits) or LTKRN (Imaging, 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_DriveCount

Topics

• Functions
• How to use the DVD Burner to burn ISO files and DVD images

Example

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

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