This method allocates a new stream sample object for the current media stream.

HRESULT AllocateSample(
  DWORD dwFlags,
  IStreamSample** ppSample


  • dwFlags
    [in] Flags. Must be zero.
  • ppSample
    [out] Address of a pointer to the newly created stream sample's IStreamSample interface.

Return Values

Returns one of the following values.

Value Description
E_OUTOFMEMORY There is not enough memory available to create a stream sample.
E_POINTER A parameter is invalid.
S_OK Success.


This method allocates the sample and its associated backing object or buffer. The backing object is either the Microsoft DirectDraw® surface for video or the IAudioData object for audio.


DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IMediaStream Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.