MFGetAttributeUINT64 function (mfapi.h)

Returns a UINT64 value from an attribute store, or a default value if the attribute is not present.

Syntax

UINT64 MFGetAttributeUINT64(
  [in] IMFAttributes *pAttributes,
  [in] REFGUID       guidKey,
  [in] UINT64        unDefault
);

Parameters

[in] pAttributes

Pointer to the IMFAttributes interface of the attribute store.

[in] guidKey

GUID that identifies which value to retrieve.

[in] unDefault

Default value to return if the attribute store does not contain the specified attribute.

Return value

Returns a UINT64 value.

Remarks

This helper function queries the attribute store for the UINT64 value specified by guidKey. If the value is not present, the function returns unDefault.

This function is convenient because it never returns a failure code. However, if the attribute in question does not have a meaningful default value, you should call IMFAttributes::GetUINT64 and check for MF_E_ATTRIBUTENOTFOUND.

Requirements

See also

Attributes and Properties

IMFAttributes::GetUINT64

Media Foundation Functions