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.
| Return code | Description |
|---|---|
|
The method succeeded. |
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
| 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 |
See also
IMFASFProfile::AddMutualExclusion