IMediaPropertyBag Interface

The IMediaPropertyBag interface is exposed on filters that need to record copyright information. The interface inherits from the IPropertyBag interface and supports its Read and Write methods for properties. It includes one additional method, EnumProperty, which retrieves or sets a property and value pair.

You can find more information on the IMediaPropertyBag interface in the COM documentation of the Platform SDK.

Implement this interface when you need to expose copyright information on filters.

Applications should use this interface when they need to copyright the stream name of a multimedia file.

Methods in Vtable Order

IUnknown methods Description
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.

IMediaPropertyBag methods Description

EnumProperty Retrieves or sets a property and value pair.

IUnknown methods	Description
QueryInterface	Retrieves pointers to supported interfaces.
AddRef	Increments the reference count.
Release	Decrements the reference count.
IMediaPropertyBag methods	Description
EnumProperty	Retrieves or sets a property and value pair.

IMediaPropertyBag::EnumProperty

IMediaPropertyBag Interface

Retrieves or sets a property and value pair.

Syntax

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

Parameters

iProperty
[in] Index value of the pair to get or set.
pvarPropertyName
[in, out] Pointer to the property's name.
pvarPropertyValue
[in, out] Pointer to the property's value.

Return Value

Returns HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS) if the iProperty parameter is larger than the number of properties there are (iProperty is zero-based). Otherwise, it will return an HRESULT value that depends on the implementation of the interface.

Remarks

The pvarPropertyName parameter is always a string; the caller should set the variant type to VT_EMPTY or VT_BSTR before calling this method. The pvarPropertyValue parameter can be any variant; the caller should set the variant type to VT_EMPTY or what is expected.