IMFASFContentInfo::GetProfile method (wmcontainer.h)

Article
02/22/2024

Retrieves an Advanced Systems Format (ASF) profile that describes the ASF content.

Syntax

HRESULT GetProfile(
  [out] IMFASFProfile **ppIProfile
);

Parameters

[out] ppIProfile

Receives an IMFASFProfile interface pointer. The caller must release the interface. If the object does not have an ASF profile, this parameter receives the value NULL.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.

Remarks

The profile is set by calling either IMFASFContentInfo::SetProfile or IMFASFContentInfo::ParseHeader.

The ASF profile object returned by this method does not include any of the MF_PD_ASF_xxx attributes (see Presentation Descriptor Attributes). To get these attributes, do the following:

Call IMFASFContentInfo::GeneratePresentationDescriptor to get the ASF presentation descriptor. You can query the presentation descriptor for the MF_PD_ASF_xxx attributes.
(Optional.) Call MFCreateASFProfileFromPresentationDescriptor to convert the presentation descriptor into an ASF profile. The profile object created by this function contains the MF_PD_ASF_xxx attributes.

An ASF profile is a template for file encoding, and is intended mainly for creating ASF content. If you are reading an existing ASF file, it is recommended that you use the presentation descriptor to get information about the file. One exception is that the profile contains the mutual exclusion and stream prioritization objects, which are not exposed directly from the presentation descriptor.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	wmcontainer.h
Library	Mfuuid.lib