Share via

IMediaPropertyBag::EnumProperty

  • Article
 
Microsoft DirectShow 9.0

IMediaPropertyBag::EnumProperty

The EnumProperty method retrieves a property/value pair.

Syntax

  HRESULT EnumProperty(
  ULONG iProperty,
  VARIANT *pvarPropertyName,
  VARIANT *pvarPropertyValue
);

Parameters

iProperty

[in] Index value of the pair.

pvarPropertyName

[in, out] Pointer to a VARIANT that receives the property's name.

pvarPropertyValue

[in, out] Pointer to a VARIANT that receives the property's value.

Return Values

Returns an HRESULT value. Possible values include the following:

Return code Description
S_OK Success.
E_INVALIDARG Invalid argument.
E_OUTOFMEMORY Insufficient memory.
E_POINTER NULL pointer argument.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS) Index out of range.

Remarks

The name is always a string. Set the variant type of the pvarPropertyName parameter to VT_EMPTY or VT_BSTR before calling this method.

The value can be a string (for INFO chunks) or an array of bytes (for DISP chunks). Set the variant type of the pvarPropertyName parameter to VT_EMPTY, VT_BSTR, or (VT_ARRAY | VT_UI1).

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also