IToc::GetContext 方法 (wmcodecdsp.h)

GetContext 方法检索以前通过调用 SetContext 与目录关联的字节块。

语法

HRESULT GetContext(
  [in, out] DWORD *pdwContextSize,
  [out]     BYTE  *pbtContext
);

参数

[in, out] pdwContextSize

如果 pbtContextNULL,则这是接收上下文块的大小(以字节为单位)的输出参数。 如果 pbtContext 不为 NULL,则这是一个输入参数,用于指定 pbtContext 指向的调用方分配的缓冲区的大小(以字节为单位)。

[out] pbtContext

NULL,或指向调用方分配的缓冲区的指针,该缓冲区在成功完成后接收上下文块。

返回值

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

返回代码 说明
S_OK
方法成功。
MF_E_BUFFERTOOSMALL
如果 pbtContext 不为 NULL 且上下文块大于 bdwContextSize 指定的大小,则该方法将返回此错误代码。 在这种情况下, pdwContextSize 用作输出参数,并接收所需缓冲区的大小(以字节为单位)。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wmcodecdsp.h
DLL Wmvdspa.dll

另请参阅

IToc