IAMTimelineSrc::SetStreamNumber

 
Microsoft DirectShow 9.0

IAMTimelineSrc::SetStreamNumber

The SetStreamNumber method specifies which stream to read from the source file associated with this source object.

Syntax

  HRESULT SetStreamNumber(
    long Val
);

Parameters

Val

The stream number, from the set of streams matching the media type of the parent group.

Return Value

Returns S_OK if successful, or E_INVALIDARG if Val is less than zero.

Remarks

The Val parameter specifies a stream number from the set of streams that matches the parent group's media type, not from the entire set of streams in the source file. For example, For example, suppose that a file contains two video streams and two audio streams. If the source object is inside a video group, setting Val to 0 selects the first video stream. The caller is responsible for specifying a valid stream number.

The stream number defaults to zero.

Requirements

Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.

Library: Use strmiids.lib.

See Also