Share via


IMediaStream::CreateSharedSample (Windows Embedded CE 6.0)

1/6/2010

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

Windows Embedded CE Windows CE 2.12 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later

See Also

Reference

IMediaStream Interface