IMFASFProfile::GetMutualExclusion 方法 (wmcontainer.h)

从配置文件中检索高级系统格式 (ASF) 互斥对象。

语法

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

参数

[in] dwMutexIndex

配置文件中互斥对象的索引。

[out] ppIMutex

接收指向 ASF 互斥对象的 IMFASFMutualExclusion 接口的指针。 调用方必须释放接口。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。

注解

此方法不会创建互斥对象的副本。 返回的指针引用配置文件对象中包含的互斥。 不得使用此指针对相互排除对象进行任何更改,因为这样做可能会以意外的方式影响配置文件对象。

若要更改配置文件中互斥对象的配置,必须先通过调用 IMFASFMutualExclusion::Clone 来克隆互斥对象。 对对象的克隆进行所需的任何更改,通过调用 IMFASFProfile::RemoveMutualExclusion 方法从配置文件中删除旧的互斥对象,然后通过调用 IMFASFProfile::AddMutualExclusion 方法添加更新的对象。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wmcontainer.h
Library Mfuuid.lib

另请参阅

ASF 配置文件

IMFASFMutualExclusion

IMFASFProfile

IMFASFProfile::AddMutualExclusion

IMFASFProfile::GetMutualExclusionCount

IMFASFProfile::RemoveMutualExclusion