MFPMediaItem_AddRef

Increments the reference count for an interface pointer to a COM object. You should call this method whenever you make a copy of an interface pointer.

MFPMediaItem_AddRef PROTO pMediaItem:DWORD

Parameters

pMediaItem - A pointer to the Media Item (IMFPMediaItem) object.

Returns

TRUE if successful or FALSE otherwise.

Notes

A COM object uses a per-interface reference-counting mechanism to ensure that the object doesn’t outlive references to it. You use AddRef to stabilize a copy of an interface pointer. It can also be called when the life of a cloned pointer must extend beyond the lifetime of the original pointer. The cloned pointer must be released by calling IUnknown_Release on it.

The internal reference counter that AddRef maintains should be a 32-bit unsigned integer.