IEnumStreamBufferRecordingAttrib::Next method (sbe.h)

Article
12/05/2018

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

The Next method returns a specified number of attributes in the enumeration sequence.

Syntax

HRESULT Next(
  [in]      ULONG                  cRequest,
  [in, out] STREAMBUFFER_ATTRIBUTE *pStreamBufferAttribute,
  [out]     ULONG                  *pcReceived
);

Parameters

[in] cRequest

The number of attributes to retrieve.

[in, out] pStreamBufferAttribute

Pointer to an array of size cRequest. The array is filled with STREAMBUFFER_ATTRIBUTE structures.

[out] pcReceived

Pointer to a variable that receives the number of attributes that are returned in the pStreamBufferAttribute array. This parameter can be NULL if cRequest is 1.

Return value

Returns an HRESULT value. Possible values include the following.

Return code	Description
E_INVALIDARG	Invalid argument.
E_POINTER	NULL pointer argument.
S_FALSE	Did not retrieve as many attributes as requested (reached the end of the enumeration).
S_OK	Success.

Remarks

The caller allocates the array of STREAMBUFFER_ATTRIBUTE structures, but the method allocates buffers for the attributes and the attribute names, which are contained in the pszName and pbAttribute members of each structure. The caller must release those buffers, by calling CoTaskMemFree.

Requirements

Requirement	Value
Minimum supported client	Windows�XP with SP1 [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	sbe.h

Share via