| Microsoft DirectX 8.1 (C++) |
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.
See Also