IMFASFProfile::GetMutualExclusion method (wmcontainer.h)

Retrieves an Advanced Systems Format (ASF) mutual exclusion object from the profile.

Syntax

HRESULT GetMutualExclusion(
  [in]  DWORD                 dwMutexIndex,
  [out] IMFASFMutualExclusion **ppIMutex
);

Parameters

[in] dwMutexIndex

Index of the mutual exclusion object in the profile.

[out] ppIMutex

Receives a pointer to the IMFASFMutualExclusion interface of the ASF mutual exclusion object. The caller must release the interface.

Return value

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

Remarks

This method does not create a copy of the mutual exclusion object. The returned pointer refers to the mutual exclusion contained in the profile object. You must not make any changes to the mutual exclusion object using this pointer, because doing so can affect the profile object in unexpected ways.

To change the configuration of the mutual exclusion object in the profile, you must first clone the mutual exclusion object by calling IMFASFMutualExclusion::Clone. Make whatever changes are required to the clone of the object, remove the old mutual exclusion object from the profile by calling the IMFASFProfile::RemoveMutualExclusion method, and then add the updated object by calling the IMFASFProfile::AddMutualExclusion method.

Requirements

See also

ASF Profile

IMFASFMutualExclusion

IMFASFProfile

IMFASFProfile::AddMutualExclusion

IMFASFProfile::GetMutualExclusionCount

IMFASFProfile::RemoveMutualExclusion