IAMStreamSelect::Info

Article
11/18/2015

A version of this page is also available for

4/8/2010

This method retrieves information about a given stream.

Syntax

HRESULT Info(
  long lIndex,
  AM_MEDIA_TYPE** ppmt,
  DWORD* pdwFlags,
  LCID* plcid,
  DWORD* pdwGroup,
  WCHAR** ppszName,
  IUnknown** ppObject,
  IUnknown** ppUnk 
);

Parameters

lIndex
[in] Index number of desired stream. Zero-based.

ppmt
[out] Address of a pointer to the stream's media type. Optional. Use the DeleteMediaType function to free the AM_MEDIA_TYPE structure when done.

pdwFlags
[out] Optional pointer to flags indicating the stream state. Valid values include the following.

Value	Description
Zero	This stream is disabled.
AMSTREAMSELECTINFO_ENABLED	The stream is enabled, and others in this group might be enabled too.
AMSTREAMSELECTINFO_EXCLUSIVE	This stream is the only enabled stream in the group.

plcid
[out] Pointer to the locale context (LCID) value. This parameter points to a zero value if there is no LCID. Optional.

pdwGroup
[out] Pointer to the logical group. Optional.

ppszName
[out] Address of a pointer to the stream name. Optional. Free with the CoTaskMemFree function when done.

ppObject
[out] Address of a pointer to the pin or filter object associated with this stream. Optional. The object can change if the IAMStreamSelect::Enable method is called. This parameter contains a null value upon return from this method if there is no associated object.

ppUnk
[out] Address of a pointer to a stream-specific interface.

Return Value

Returns an HRESULT value that depends on the implementation of the interface. The current DirectShow implementation returns S_FALSE if lIndex is out of range, or S_OK otherwise.

Remarks

The first stream in each group is the default.

Requirements

Windows Embedded CE	Windows CE 2.12 and later
Windows Mobile	Windows Mobile Version 5.0 and later
Note	Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later

Share via