IMultiMediaStream::EnumMediaStreams

  • Article

This method retrieves a media stream from a multimedia stream by zero-based index.

HRESULT EnumMediaStreams(
  long Index,
  IMediaStream** ppMediaStream
);

Parameters

  • Index
    [in] Index of the stream array to check.
  • ppMediaStream
    [out] Address of a pointer to an IMediaStream interface object. On return, it contains a pointer to the stream at the specified index.

Return Values

Returns one of the following values.

Value Description
E_POINTER The ppMediaStream pointer is invalid.
S_FALSE Index is out of range; no streams are left to enumerate. When the method returns this value, it also sets ppMediaStream to NULL.
S_OK Success.

Remarks

You should call this method until it returns S_FALSE, which indicates that the stream enumeration is complete.

Requirements

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

IMultiMediaStream Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.