ISBE2Crossbar::EnableDefaultMode method

Enables or disables the profile default mode and stream default mode for a crossbar in a Stream Buffer Source filter. The profile describes a set of media types that can be used to create out pins, one media type per output pin. The stream mapping describes the mappings between the streams within a WTV file and filter output pins.

If you do not call the EnableDefaultMode method in your application, the crossbar uses a default profile and a default stream map. In this case, the crossbar is said to be in profile default mode and stream default mode, respectively. You can use the EnableDefaultMode method to disable either mode or both modes, so that you can specify custom profiles or stream mappings. You can also use an EnableDefaultMode(FALSE) call to disable both default modes.

Syntax

HRESULT EnableDefaultMode(
  DWORD DefaultFlags
);

Parameters

DefaultFlags

Specifies the default modes for the crossbar. This can be any combination of the following values.

Value Meaning
DEF_MODE_PROFILE
Enables profile default mode. The default profile is used, and you cannot specify custom profiles by calling the SetOutputProfile method. If you omit this flag, profile default mode is disabled so that you can specify a custom output profile.
DEF_MODE_STREAMS
Enables stream default mode. The Stream Buffer Enging (SBE) handles the mapping between streams and output pins, and you cannot change these mappings by calling the ISBE2StreamMap::MapStream method. If you omit this flag, stream default mode is disabled, so that you can specify a custom mapping.

Return Value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

In stream default mode, SBE first checks the Windows Media Center TV settings to determine if a preferred language is set. If a preferred language is set:

  • If an audio stream in the preferred language exists, SBE outputs that audio stream.
  • If an audio stream in the preferred language does not exist, SBE outputs the default audio stream, which is set when the stream is captured.
If no preferred language is set, Windows Media Center is either not present or not configured. In this case:
  • If an audio stream in the language the operating system locale exists, SBE outputs that audio stream.
  • Otherwise, SBE outputs the default audio stream.

Requirements

   
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header sbe.h

See Also

ISBE2Crossbar

ISBE2Crossbar::SetOutputProfile

ISBE2StreamMap::MapStream

Stream Buffer Source Filter