Microsoft DirectX 9.0

MSVidWebDVD.GPRM Property

This topic applies to Windows XP Service Pack 1 only.

The GPRM property specifies and retrieves the specified general parameter register.

Syntax

VidWebDVD.GPRM(
  lIndex As Long
) As Short

Parameters

lIndex

Long specifying the general parameter register. The value must range from 0 through 15.

Return Values

When getting the value, this property returns a Short.

Error Codes

If the property fails, Err.Number may be set to one of the following values.

Value Description
E_UNEXPECTED Unspecified error.
E_INVALIDARG Index is less than 0 or greater than 15.

Remarks

General parameter registers, or GPRMs, are 16-bit registers that each disc can use in unique ways for temporary data storage. A player application does not need to access these registers for any standard playback or navigation control using the MSVidWebDVD object. 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 disc to be played. Changing these values can result in unpredictable behavior.

Example

' Setting the property.
VidWebDVD.GPRM(lIndex) = sRegister
' Returning the property.
sRegister = VidWebDVD.GPRM(lIndex)

Valid Domains

The following table shows the Annex J command name to which this method name corresponds, and the domains in which this method is valid.

Annex J Command Name Valid Domains
none All

See Also