IltmmDVDControl::get_CurrentVolume

#include "ltmm.h"

C Syntax

HRESULT IltmmDVDControl_get_CurrentVolume(pDVD, pVolume)

C++ Syntax

HRESULT get_CurrentVolume(pVolume)

 

IltmmDVDControl *pDVD;

/* pointer to an interface */

long *pVolume;

/* pointer to a variable */

Retrieves the current DVD volume.

Parameter

Description

pDVD

Pointer to an IltmmDVDControl interface.

pVolume

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.

Required DLLs and Libraries

LTMM

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

Elements:

IltmmDVDControl interface, IltmmDVDControl::get_CurrentDomain, IltmmDVDControl::get_CurrentTitle, IltmmDVDControl::get_CurrentChapter, IltmmDVDControl::get_CurrentDiscSide, IltmmDVDControl::get_CurrentTime, IltmmDVDControl::get_CurrentUOPS, IltmmDVDControl::get_CurrentButton, IltmmDVDControl::get_CurrentAngle, IltmmDVDControl::get_CurrentAudioStream, IltmmDVDControl::get_CurrentSubpictureStream, IltmmDVDControl::get_VolumesAvailable

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmDVDControl::GetButtonAtPosition Example for C.

For a C++ example, refer to IltmmDVDControl::GetButtonAtPosition Example for C++.