Edit

DVD_CMD_FLAGS enumeration (strmif.h)

  • Article

[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.]

Defines flags that control how the DVD Navigator Filter filter handles command synchronization.

Syntax

typedef enum __MIDL___MIDL_itf_strmif_0000_0132_0002 {
  DVD_CMD_FLAG_None = 0,
  DVD_CMD_FLAG_Flush = 0x1,
  DVD_CMD_FLAG_SendEvents = 0x2,
  DVD_CMD_FLAG_Block = 0x4,
  DVD_CMD_FLAG_StartWhenRendered = 0x8,
  DVD_CMD_FLAG_EndAfterRendered = 0x10
} DVD_CMD_FLAGS;

Constants

 
DVD_CMD_FLAG_None
Value: 0
The DVD Navigator will not flush its buffers when it issues the command, will not send any events, and will not to block the thread of execution on any method call.
DVD_CMD_FLAG_Flush
Value: 0x1
The DVD Navigator will flush all of its buffered video data before issuing the command. This can cause the DVD Navigator to discard approximately two seconds of video, which will decrease the response time but cause a gap in the playback data.
DVD_CMD_FLAG_SendEvents
Value: 0x2
The DVD Navigator will send an EC_DVD_CMD_START event when the command begins, and an EC_DVD_CMD_END event when the command ends. The event parameters contain the status code of the operation.
DVD_CMD_FLAG_Block
Value: 0x4
The DVD Navigator blocks until the command completes or is canceled.
DVD_CMD_FLAG_StartWhenRendered
Value: 0x8
Currently not used.
DVD_CMD_FLAG_EndAfterRendered
Value: 0x10
The DVD Navigator will block until the specified action is actually rendered. This flag can be used with the following methods:


For example, when used with PlayChaptersAutoStop, this flag causes the DVD Navigator to block until the specified chapters have all played. When used with SelectSubpictureStream, the flag causes the DVD Navigator to block until the new subpicture is rendered.

Requirements

Requirement Value
Header strmif.h (include Dshow.h)

See also

DirectShow Enumerated Types

Synchronizing DVD Commands