ISBE2Crossbar::SetOutputProfile 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.]
Replaces the default or current input profile with the profile specified in this method.
You can discover the current input profile by calling the GetInitialProfile method. This profile can be changed over time as media types are updated on input to the Stream Buffer Source filter.
A custom profile can contain only one stream per major media type. For example, a custom profile can contain only a single audio stream.
By default, the filter crossbar has profile default mode enabled, which means that you cannot set a custom output profile. Before you can set a custom output profile, you must disable profile default mode by calling the EnableDefaultMode method without the DEF_MODE_PROFILE flag.
Syntax
HRESULT SetOutputProfile(
[in] ISBE2MediaTypeProfile *pProfile,
[in, out] DWORD *pcOutputPins,
[in, out] IPin **ppOutputPins
);
Parameters
[in] pProfile
Pointer to the ISBE2MediaTypeProfile interface for the profile that replaces the crossbar default profile.
[in, out] pcOutputPins
On input, specifies the size of an array allocated to receive IPin pointers for the output pins that correspond to the streams in the new profile. The ppOutputPins parameter points to this array. On output, if the call succeeds, gets the actual number of IPin pointers returned in the ppOutputPins output parameter.
[in, out] ppOutputPins
On input, specifies a pointer to an array of uninitialized IPin pointers. On output, if the call succeeds, the IPin pointers in the array are initialized to point to the filter output pins that have the media types listed in the new profile. The pcOutputPins parameter gives the number of elements in the array. The caller is responsible for freeing the IPin interface pointers returned in the array.
Return value
Returns an HRESULT value. Possible values include the following.
Return value | Description |
---|---|
|
Success. |
|
The pProfile parameter is NULL. |
|
The pcOutputPins parameter is NULL. |
|
Cannot set output profile because profile default mode is enabled. |
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows�7 [desktop apps only] |
Minimum supported server | None supported |
Target Platform | Windows |
Header | sbe.h |