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: |
Example
For a C example, refer to IltmmDVDControl::GetButtonAtPosition Example for C.
For a C++ example, refer to IltmmDVDControl::GetButtonAtPosition Example for C++.