| Microsoft DirectX 9.0 |
The Clone method makes a copy of the enumerator with the same enumeration state.
Syntax
HRESULT Clone(
IEnumPins **ppEnum
);
Parameters
ppEnum
[out] Address of a variable that receives a pointer to the IEnumPins interface of the new enumerator.
Return Values
Returns one of the following HRESULT
| Value | Description |
| S_OK | Success. |
| E_OUTOFMEMORY | Insufficient memory. |
| E_POINTER | NULL pointer argument. |
| VFW_E_ENUM_OUT_OF_SYNC | The filter's state has changed and is now inconsistent with the enumerator. |
Remarks
If the number of pins changes, the enumerator is no longer consistent with the filter, and the method returns VFW_E_ENUM_OUT_OF_SYNC. Discard any data obtained from previous calls to the enumerator, because it might be invalid. Update the enumerator by calling the IEnumPins::Reset method. You can then call the Clone method safely.
See Also