Microsoft DirectX 8.1 (C++)

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 Value

Returns an HRESULT value. Possible values include the following:

Value 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).

See Also