ISBE2EnumStream::Next method (sbe.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

Retrieves the next n streams in the collection.

Syntax

HRESULT Next(
  [in]      ULONG            cRequest,
  [in, out] SBE2_STREAM_DESC *pStreamDesc,
  [out]     ULONG            *pcReceived
);

Parameters

[in] cRequest

The number of streams to retrieve.

[in, out] pStreamDesc

Pointer to an array of SBE2_STREAM_DESC structures, with at least cRequest elements. The method copies up to cRequest elements into the array.

[out] pcReceived

Receives the number of elements returned in the pStreamDesc array. This parameter can be NULL if cRequest is 1.

Return value

This method can return one of these values.

Return code Description
S_OK
The method succeeded and retrieved cRequest elements.
S_FALSE
The method retrieved fewer elements than requested.
E_FAIL
The streams have changed, so the caller must enumerate them again.

Requirements

Requirement Value
Minimum supported client Windows�7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header sbe.h
DLL Sbe.dll

See also

ISBE2EnumStream