MFLockPlatform 函数 (mfapi.h)

阻止 MFShutdown 函数。

语法

HRESULT MFLockPlatform();

返回值

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

返回代码 说明
S_OK
函数成功。

注解

此函数可防止在调用 MFShutdown 时关闭工作队列线程。 使用此函数可确保在平台关闭之前正常完成异步操作。

此函数在 Media Foundation 平台上保留一个锁。 若要解锁平台,请调用 MFUnlockPlatform。 每次调用 MFLockPlatform 时,应用程序都必须调用 MFUnlockPlatform 一次。

MFShutdown 函数将阻止,直到平台解锁或固定等待期已过。 (等待期为几秒钟。) 为了避免内存泄漏,应用程序应在等待期结束前解锁平台。 例如,取消等待完成且在平台上持有锁的任何异步操作。

创建结果对象时 ,IMFAsyncResult 接口的默认实现会自动锁定 Media Foundation 平台。 释放接口会解锁平台。 因此,在大多数情况下,应用程序不需要直接锁定平台。 有关详细信息,请参阅 工作队列

如果安装了 Windows Media Format 11 SDK 可再发行组件,则此函数在以下平台上可用:

  • 具有 Service Pack 2 的 Windows XP (SP2) 及更高版本。
  • Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) 和安装KB925766 (2006 年 10 月更新汇总的 Windows XP Media Center Edition) 。

要求

   
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

另请参阅

媒体基础函数

Media Foundation 平台 API

工作队列