Share via


IDvdControl2::Pause

 
Microsoft DirectShow 9.0

IDvdControl2::Pause

The Pause method pauses or resumes playback at the current location.

Syntax

  HRESULT Pause(
  BOOL bState
);

Parameters

bState

[in] Value of type Boolean that specifies whether to pause playback; TRUE means to pause.

Return Values

Returns one of the following values.

Return code Description
S_OK Success.
VFW_E_DVD_INVALIDDOMAIN Invalid domain.
VFW_E_DVD_OPERATION_INHIBITED UOP control prohibits the DVD Navigator from entering a paused state.

Remarks

Putting the DVD Navigator into a paused state freezes playback and any internal timers, similar to IMediaControl::Pause. If the filter graph is not running, this method does nothing.

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
Pause_On, Pause_Off DVD_DOMAIN_VideoManagerMenu
DVD_DOMAIN_VideoTitleSetMenu
DVD_DOMAIN_Title

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also