IEnumStreamIdMap::Next method (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The Next method retrieves the next n elements in the collection.
Syntax
HRESULT Next(
[in] ULONG cRequest,
[in, out] STREAM_ID_MAP *pStreamIdMap,
[out] ULONG *pcReceived
);
Parameters
[in] cRequest
The number of elements to retrieve.
[in, out] pStreamIdMap
Address of a user-allocated array containing cRequest elements that will receive the retrieved STREAM_ID_MAP structures.
[out] pcReceived
Receives the number of elements actually retrieved.
Return value
Returns S_OK if successful. If the method fails,an HRESULT error code is returned.
Remarks
If cRequest >= 0 and pcReceived is not NULL, upon return pcReceived contains the number of stream ID maps remaining in the collection.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |
| Library | Strmiids.lib |