Share via

IMSVidFeatures::get__NewEnum Method

  • Article

This topic applies to Windows XP or later.
The get__NewEnum method retrieves an enumerator for the collection.

Syntax

HRESULT get__NewEnum(
  [out]  IEnumVARIANT **ppD
);

Parameters

  • ppD [out]
    Pointer to a variable that receives an IEnumVARIANT interface pointer.

Return Value

Returns an HRESULT value. Possible values include the following.

Return code Description

S_OK

Success.

E_OUTOFMEMORY

Insufficient memory.

E_POINTER

NULL pointer argument.

Remarks

This method is provided so that Automation clients can iterate through the collection using a For...Each loop.

The returned IEnumVARIANT interface is not thread safe, because it is intended primarily for use by Automation clients. Clients should not call methods on the interface from more than one thread. (C++ applications should generally use the IMSVidFeatures::get_Item method instead.)

If the method succeeds, the IEnumVARIANT interface has an outstanding reference count. The caller must release the interface.

Requirements

Header Declared in Dshow.h.
DLL Requires Quartz.dll.

See Also

IMSVidFeatures Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008