| Microsoft DirectX 8.1 (C++) |
The Info 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 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.
See Also