Share via

IMediaStream::CreateSharedSample (Compact 2013)

  • Article

3/26/2014

This method creates a new stream sample that shares the same backing object as the existing sample.

Syntax

HRESULT CreateSharedSample(
  IStreamSample* pExistingSample,
  DWORD dwFlags,
  IStreamSample** ppNewSample
);

Parameters

  • pExistingSample
    [in] Pointer to the existing sample.
  • dwFlags
    [in] Reserved for flag data. Must be zero.
  • ppNewSample
    [out] Address of a pointer to an IStreamSample interface that will point to the newly created shared sample.

Return Value

Returns one of the following values.

Value

Description

E_OUTOFMEMORY

There is not enough memory available to create the sample.

E_POINTER

One of the parameters is invalid.

MS_E_INCOMPATIBLE

The existing sample is not compatible with the specified media stream.

S_OK

Success; ppNewSample points to the newly created sample.

Remarks

This method calls IUnknown::QueryInterface on the existing sample to retrieve the media type-specific information, which it uses to create the shared sample.

Requirements

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IMediaStream Interface