Microsoft DirectX 9.0

IDvdInfo2::GetAllGPRMs

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