IEnumStreamBufferRecordingAttrib::Next Method

Article
01/07/2009

This topic applies only to Windows XP Service Pack 1 or later.
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

cRequest [in]
The number of attributes to retrieve.
pStreamBufferAttribute [in, out]
Pointer to an array of size cRequest. The array is filled with STREAMBUFFER_ATTRIBUTE structures.
pcReceived [out]
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

Header

Declared in Sbe.h.