IDirectXVideoDecoder::BeginFrame 方法 (dxva2api.h)

启动解码操作。

语法

HRESULT BeginFrame(
  [in] IDirect3DSurface9 *pRenderTarget,
  [in] void              *pvPVPData
);

参数

[in] pRenderTarget

指向将写入解码帧的呈现目标的 IDirect3DSurface9 接口的指针。

[in] pvPVPData

保留;设置为 NULL

返回值

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

返回代码 说明
S_OK
方法成功。
E_INVALIDARG
图面类型无效。 请参阅“备注”。

注解

调用此方法后,调用 IDirectXVideoDecoder::Execute 以执行解码操作。 执行所有解码操作后,调用 IDirectXVideoDecoder::EndFrame

BeginFrame 的每次调用都必须具有对 EndFrame 的匹配调用,并且 BeginFrame 调用不能嵌套。

DXVA 1.0 迁移说明:与 IAMVideoAccelerator::BeginFrame 方法不同,该方法将缓冲区指定为索引,此方法将指针直接指向未压缩的缓冲区。

pRenderTarget 指向的图面必须通过调用 IDirectXVideoAccelerationService::CreateSurface 来创建,值为 DxvaType DXVA2_VideoDecoderRenderTarget。

要求

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

请参阅

DirectX 视频加速 2.0

IDirectXVideoDecoder