IMediaObject::SetInputType

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method sets the media type on an input stream or tests whether a media type is acceptable.

Syntax

HRESULT SetInputType(
  DWORD dwInputStreamIndex,
  const DMO_MEDIA_TYPE* pmt,
  DWORD dwFlags
);

Parameters

• dwInputStreamIndex
  Zero-based index of an input stream on the DMO.

• pmt
  [in] Pointer to a DMO_MEDIA_TYPE structure that specifies themedia 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 the following.

Remarks

Call this method to test, set, or clear the media type on an input 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.

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

Requirements

See Also

Reference

IMediaObject
IMediaObject::SetOutputType
MoFreeMediaType
DMO Error Codes
DMO Error Codes
DMO_MEDIA_TYPE
DMO_SET_TYPE_FLAGS