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
| Windows Embedded CE | Windows CE 2.12 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 |