MFGetAttributeUINT64

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

Syntax

UINT64 MFGetAttributeUINT64(
         IMFAttributes *pAttributes,
         REFGUID guidKey,
         UINT64 unDefault
)

Parameters

pAttributes
Type: IMFAttributes *

Pointer to the IMFAttributes interface of the attribute store.

guidKey
Type: REFGUID

GUID that identifies which value to retrieve.

unDefault
Type: UINT64

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

Return value

Type: UINT64

Returns a UINT64 value.

Return codes

Return code	Description

Refer to Media Foundation return codes.

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

Header: Declared in mfapi.h.