Share via


IAMStreamSelect::Info

A version of this page is also available for

Windows Embedded CE 6.0 R3

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