In This Topic ▼

IltmmDVDControl::get_CurrentVolume

#include "ltmm.h"

C Syntax	HRESULT IltmmDVDControl_get_CurrentVolume(pDVD, pVal)
C++ Syntax	HRESULT get_CurrentVolume(pVal)

IltmmDVDControl *pDVD;	pointer to an interface
long *pVal;	pointer to a variable

Retrieves the current DVD volume.

Parameter	Description
pDVD	Pointer to an IltmmDVDControl interface.
pVal	Pointer to a variable that receives the volume number for the root directory.

Returns

S_OK	The function ran successfully.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Each DVD disc has a single volume number, assigned to it by the manufacturer, that identifies a disc's position in a multi-disc DVD set. For example, the programmer can implement code in a DVD playback routine, called when playing a multi-disc movie, that checks the DVD's volume number to ensure that the end user does not insert the discs out of order.

To retrieve other "current" information, use the following functions:

IltmmDVDControl::get_CurrentTitle

IltmmDVDControl::get_CurrentChapter

IltmmDVDControl::get_CurrentDiscSide

IltmmDVDControl::get_CurrentTime

IltmmDVDControl::get_CurrentButton

IltmmDVDControl::get_CurrentAngle

IltmmDVDControl::get_CurrentUOPS

IltmmDVDControl::get_CurrentAudioStream

IltmmDVDControl::get_CurrentSubpictureStream

IltmmDVDControl::get_CurrentDomain

For more detailed information, refer to the Microsoft documentation for IDvdInfo2::GetDVDVolumeInfo.