IMFAsyncResult::GetState 方法 (mfobjects.h)

返回由异步 Begin 方法中的调用方指定的状态对象。

语法

HRESULT GetState(
  [out] IUnknown **ppunkState
);

参数

[out] ppunkState

接收指向状态对象的 IUnknown 接口的指针。 如果值不为 NULL,则调用方必须释放接口。

返回值

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

返回代码 说明
S_OK
方法成功。
E_POINTER
没有与此异步结果关联的状态对象。

注解

异步方法的调用方指定状态对象,并且可以将其用于任何调用方定义的用途。 状态对象可以为 NULL。 如果状态对象为 NULL则 GetState 返回 E_POINTER

如果要实现异步方法,请通过 MFCreateAsyncResult 函数的 punkState 参数在 上设置 state 对象。

如果安装了 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
标头 mfobjects.h (包括 Mfidl.h)
Library Mfuuid.lib

另请参阅

异步回调方法

IMFAsyncResult