IEnumStreamBufferRecordingAttrib::Next

  • Article
 
Microsoft DirectShow 9.0

IEnumStreamBufferRecordingAttrib::Next

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(
    ULONG cRequest,
    STREAMBUFFER_ATTRIBUTE *pStreamBufferAttribute,
    ULONG *pcReceived
);

Parameters

cRequest

[in]  The number of attributes to retrieve.

pStreamBufferAttribute

[in, out, size_is(cRequest)]  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 Values

Returns an HRESULT value. Possible values include the following.

Value 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: Include Sbe.h.

See Also