Share via

_DMO_OUTPUT_STREAM_INFO_FLAGS enumeration (mediaobj.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.]

The DMO_OUTPUT_STREAM_INFO_FLAGS enumeration defines flags that describe an output stream.

Syntax

typedef enum _DMO_OUTPUT_STREAM_INFO_FLAGS {
  DMO_OUTPUT_STREAMF_WHOLE_SAMPLES = 0x1,
  DMO_OUTPUT_STREAMF_SINGLE_SAMPLE_PER_BUFFER = 0x2,
  DMO_OUTPUT_STREAMF_FIXED_SAMPLE_SIZE = 0x4,
  DMO_OUTPUT_STREAMF_DISCARDABLE = 0x8,
  DMO_OUTPUT_STREAMF_OPTIONAL = 0x10
} ;

Constants

 
DMO_OUTPUT_STREAMF_WHOLE_SAMPLES
Value: 0x1
The stream contains whole samples. Samples do not span multiple buffers, and buffers do not contain partial samples.
DMO_OUTPUT_STREAMF_SINGLE_SAMPLE_PER_BUFFER
Value: 0x2
Each buffer contains exactly one sample.
DMO_OUTPUT_STREAMF_FIXED_SAMPLE_SIZE
Value: 0x4
All the samples in this stream are the same size.
DMO_OUTPUT_STREAMF_DISCARDABLE
Value: 0x8
The stream is discardable. Within calls to IMediaObject::ProcessOutput, the DMO can discard data for this stream without copying it to an output buffer.
DMO_OUTPUT_STREAMF_OPTIONAL
Value: 0x10
The stream is optional. An optional stream is discardable. Also, the application can ignore this stream entirely; it does not have to set the media type for the stream. Optional streams generally contain additional information, or data not needed by all applications.

Remarks

The DMO_OUTPUT_STREAMF_DISCARDABLE and DMO_OUTPUT_STREAMF_OPTIONAL flags are mutually exclusive. The DMO can set one of these flags (or neither), but not both.

Requirements

Requirement Value
Header mediaobj.h

See also

DMO Enumerated Types

IMediaObject::GetOutputStreamInfo