Share via

IAMStreamSelect::Info (Compact 2013)

  • Article

3/26/2014

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

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IAMStreamSelect Interface