Share via


IMultiMediaStream::EnumMediaStreams (Compact 2013)

3/26/2014

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

Syntax

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 Value

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

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IMultiMediaStream Interface