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.

Syntax

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

Parameters

pProfile

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

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.

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

Requirements

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

See Also

EnableDefaultMode

IPin

ISBE2Crossbar

ISBE2MediaTypeProfile

Stream Buffer Source Filter