IltmmDVDControl::GetGPRM

#include "ltmm.h"

C Syntax

HRESULT IltmmDVDControl__getGPRM(pDVD, Index, pGPR)

C++ Syntax

HRESULT GetGPRM(Index, pGPR)

 

IltmmDVDControl *pDVD;

/* pointer to an interface */

long Index;

/* index */

long *pGPR;

/* pointer to a variable */

Retrieves the GPRM (general parameter registers) value at the specified index.

Parameter

Description

pDVD

Pointer to an IltmmDVDControl interface.

Index

Index of the GPRM value to retrieve. Possible values range from 0 to 15.

pGPR

Pointer to a variable that receives the GPRM value at the specified index.

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

To set the value of the general parameter register at a specific index, call IltmmDVDControl::SetGPRM.

Call IltmmDVDControl::GetSPRM to retrieve the current contents of the system parameter register (SPRM) at a specific index.

For more detailed information, refer to the Microsoft documentation for IDvdInfo2::GetAllGPRMs at http://msdn.microsoft.com/archive/default.asp?url=/library/en-us/directshow/htm/idvdinfo2getallgprms.asp.

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.

See Also

Elements:

IltmmDVDControl interface, IltmmDVDControl::GetSPRM, IltmmDVDControl::SetGPRM

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++.