IMediaObject::SetOutputType

Microsoft DirectShow 9.0

IMediaObject::SetOutputType

The SetOutputType method sets the media type on an output stream, or tests whether a media type is acceptable.

Syntax

  HRESULT SetOutputType(
    DWORD dwOutputStreamIndex,
    const DMO_MEDIA_TYPE* pmt,
    DWORD dwFlags
);

Parameters

dwOutputStreamIndex

Zero-based index of an output stream on the DMO.

pmt

[in] Pointer to a DMO_MEDIA_TYPE structure that specifies the media type.

dwFlags

Bitwise combination of zero or more flags from the DMO_SET_TYPE_FLAGS enumeration.

Return Value

Returns an HRESULT value. Possible values include those in the following table.

Return Code	Description
DMO_E_INVALIDSTREAMINDEX	Invalid stream index
DMO_E_TYPE_NOT_ACCEPTED	Media type was not accepted
S_FALSE	Media type is not acceptable
S_OK	Media type was set successfully, or is acceptable

Remarks

Call this method to test, set, or clear the media type on an output stream:

• To test the media type without setting it, use the DMO_SET_TYPEF_TEST_ONLY flag. If the media type is not acceptable, the method returns S_FALSE.
• To set the media type, set dwFlags to zero. If the media type is not acceptable, the method returns DMO_E_TYPE_NOT_ACCEPTED.
• To clear the current media type (if any), use the DMO_SET_TYPEF_CLEAR flag and set pmt to NULL. When the method returns, the stream no longer has a media type. The DMO cannot process samples until the application sets a new media type, unless the stream is optional.

The media types that are currently set on other streams can affect whether the media type is acceptable.

Requirements

  Header: Declared in Mediaobj.h; include Dmo.h
  Library: Dmoguids.lib.

See Also

• IMediaObject Interface