IMediaSample::SetMediaType

 
Microsoft DirectShow 9.0

IMediaSample::SetMediaType

The SetMediaType method sets the media type for the sample.

Syntax

  HRESULT SetMediaType(
  AM_MEDIA_TYPE *pMediaType
);

Parameters

pMediaType

Pointer to an AM_MEDIA_TYPE structure that specifies the media type.

Return Values

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

Return code Description
S_OK Success
E_OUTOFMEMORY Insufficient memory

Remarks

By default, every sample has the same media type as the previous sample. (The pin connection determines the original media type.) Call this method to make limited changes to the media type, such as changing the palette. To make a significant change to the media type, the pins might need to reconnect and renegotiate the media type.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also