IEnumFilters::Clone

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves a duplicate enumerator containing the same enumeration state as the current one.

Syntax

HRESULT Clone(
  IEnumFilters** ppEnum
);

Parameters

  • ppEnum
    [out] Duplicate of the enumerator.

Return Value

None.

Remarks

This method produces two enumerators (the original and the duplicate); both are set at the same filter.

However, after they are created they are independent. Therefore, calling the IEnumFilters::Next method for one does not affect the other.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later