ISBE2Crossbar::EnableDefaultMode method (sbe.h)
[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]
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(
[in] DWORD DefaultFlags
);
Parameters
[in] DefaultFlags
Specifies the default modes for the crossbar. This can be any combination of the following values.
| Value | Meaning |
|---|---|
|
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. |
|
Enables stream default mode. The Stream Buffer Engine (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 an audio stream in the language the operating system locale exists, SBE outputs that audio stream.
- Otherwise, SBE outputs the default audio stream.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows�7 [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | sbe.h |