MFGetAttributeUINT32 function (mfapi.h)

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

Syntax

UINT32 MFGetAttributeUINT32(
  [in] IMFAttributes *pAttributes,
  [in] REFGUID       guidKey,
  [in] UINT32        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 UINT32 value.

Remarks

This helper function queries the attribute store for the UINT32 value specified by guidKey. If the value is not present or does not have type UINT32, 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::GetUINT32 and check for MF_E_ATTRIBUTENOTFOUND.

Requirements

See also

Attributes and Properties

IMFAttributes::GetUINT32

Media Foundation Functions