IDvdInfo::GetAllGPRMs method (strmif.h)

[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  The IDvdInfo interface is deprecated. Use IDvdInfo2 instead.

 

Retrieves the current contents of all general parameter registers (GPRMs).

Syntax

HRESULT GetAllGPRMs(
  [out] GPRMARRAY *pRegisterArray
);

Parameters

[out] pRegisterArray

Pointer to the retrieved array of general parameter registers.

Return value

Returns an HRESULT value.

Return code	Description
E_UNEXPECTED	DVD is not initialized or domain is not DVD_DOMAIN_Title.
S_OK	Success.
VFW_E_DVD_INVALIDDOMAIN	Requested action is not supported on this domain (DVD_DOMAIN).
VFW_E_DVD_OPERATION_INHIBITED	Requested action cannot occur at this point in the movie due to the authoring of the current DVD-Video disc.

Remarks

This method is valid in any domain. For more information, see DVD_DOMAIN.

Use of GPRMs is title specific. GPRMs are general parameter registers. For an explanation of GPRMs, see the DVD specifications.

Requirements

Requirement	Value
Target Platform	Windows
Header	strmif.h (include Dshow.h)

See also

Error and Success Codes

IDvdInfo Interface