Share via


IEnumStreamBufferRecordingAttrib::Next Method

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.

See Also

IEnumStreamBufferRecordingAttrib Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008