IAMStreamSelect::Info (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

IAMStreamSelect Interface