Share via

IAMStreamSelect::Info

  • Article

This method retrieves information about a given stream.

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 Values

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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.