ISBE2Crossbar::SetOutputProfile method

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.


HRESULT SetOutputProfile(
  ISBE2MediaTypeProfile *pProfile,
  DWORD                 *pcOutputPins,
  IPin                  **ppOutputPins



Pointer to the ISBE2MediaTypeProfile interface for the profile that replaces the crossbar default profile.


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.


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
The pProfile parameter is NULL.
The pcOutputPins parameter is NULL.
Cannot set output profile because profile default mode is enabled.


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

See Also





Stream Buffer Source Filter