GetSPRM Method
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Note
This component is available for use in the Microsoft Windows 2000, Windows XP, and Windows Server 2003 operating systems. It may be altered or unavailable in subsequent versions.
The GetSPRM method retrieves the specified system parameter register.
[ iSPRM = ] MSWebDVD.GetSPRM(iIndex)
Parameters
-
iIndex
-
Specifies the register whose value you want to retrieve as an Integer. The Integer must range from 0 through 23.
Return Value
Returns an integer value representing the contents of the specified register.
Remarks
The disc controls system parameter registers (SPRMs). A player application doesn't need to access these registers for any standard navigation functionality. SPRMs represent the status of the player. Each one has a meaning, set by user preferences, disc commands, and other occurrences that an application has no direct control over. An application can read these registers but cannot write to them. To use these registers effectively, you will probably need a more detailed knowledge of the DVD navigation commands than is provided in this documentation. The following table shows the contents of each register. For more detailed information on the register contents, see IDvdInfo2::GetAllSPRMs
| Register | Contents |
|---|---|
| 0 | Menu language code |
| 1 | Audio stream number |
| 2 | Subpicture stream number |
| 3 | Current angle number |
| 4 | Current title number |
| 5 | Title number |
| 6 | PGC number |
| 7 | Current chapter number (PTT) |
| 8 | Highlighted button number |
| 9 | Navigation timer |
| 10 | PGC jump for nav. timer |
| 11 | Karaoke audio presentation mode |
| 12 | PML country/region code |
| 13 | PML |
| 14 | Video setting |
| 15 | Audio capability |
| 16 | Audio language |
| 17 | Audio language extension |
| 18 | Subpicture language |
| 19 | Subpicture language extension |
| 20 | Player region code |
| 21 | Reserved |
| 22 | Reserved |
| 23 | Reserved |
See also