Partager via

IMSVidInputDevices::get__NewEnum

  • Article
 
Microsoft DirectShow 9.0

IMSVidInputDevices::get__NewEnum

This topic applies to Windows XP or later.

The get__NewEnum method retrieves an enumerator for the collection.

Syntax

  HRESULT get__NewEnum(
  
  IEnumVARIANT**
  
  pD
  
  );

Parameters

  ppD

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

Return Values

Returns an HRESULT value. Possible values include the following.

Value 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 IMSVidInputDevices::get_Item method instead.)

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

Requirements

  Header: Dshow.h.

  Library: Quartz.dll.

See Also