Microsoft DirectX 9.0 |
The GetAllGPRMs method retrieves the current contents of all general parameter registers (GPRMs).
Syntax
HRESULT GetAllGPRMs(
GPRMARRAY *pRegisterArray
);
Parameters
pRegisterArray
[out] Pointer to a GPRMARRAY that receives all 16 current GPRM values. See Remarks.
Return Values
Returns one of the following HRESULT values.
Return code | Description |
S_OK | Success. |
E_POINTER | Invalid argument. |
Remarks
GPRMs are 16-bit registers that each disc can use in unique ways for temporary data storage. The file Dvdif.idl contains the following typedefs.
typedef WORD DVD_REGISTER;
typedef DVD_REGISTER GPRMARRAY[16];
typedef DVD_REGISTER SPRMARRAY[24];
Note A player application using the DVD Navigator filter does not need to access these registers for any Annex J playback or navigation control. This method is provided for player applications implementing advanced functionality. Do not attempt to modify the GPRMs directly unless you have a thorough knowledge of the DVD specification, and the ways in which the GPRMs are used on the particular discs to be played.
See Also