IDirectXVideoDecoder::GetCreationParameters 方法 (dxva2api.h)

检索用于创建此设备的参数。

语法

HRESULT GetCreationParameters(
  [out] GUID                      *pDeviceGuid,
  [out] DXVA2_VideoDesc           *pVideoDesc,
  [out] DXVA2_ConfigPictureDecode *pConfig,
  [out] IDirect3DSurface9         ***pDecoderRenderTargets,
  [out] UINT                      *pNumSurfaces
);

参数

[out] pDeviceGuid

接收设备 GUID。 此参数可以为 NULL。

[out] pVideoDesc

指向接收视频格式说明 的DXVA2_VideoDesc 结构的指针。 此参数可以为 NULL。

[out] pConfig

指向接收解码器配置的 DXVA2_ConfigPictureDecode 结构的指针。 此参数可以为 NULL。

[out] pDecoderRenderTargets

接收 IDirect3DSurface9 接口指针的数组。 这些指针表示解码器呈现目标。 方法为数组分配内存,并在每个指针上调用 AddRef 。 调用方必须释放指针并调用 CoTaskMemFree 以释放数组的内存。 此参数可以为 NULL。

[out] pNumSurfaces

接收 pppDecoderRenderTargets 数组中的元素数。 此参数可以为 NULL。

返回值

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

返回代码 说明
S_OK
方法成功。
E_INVALIDARG
无效的参数。 必须至少有一个参数为非 NULL

注解

如果对结果不感兴趣,可以将任何参数设置为 NULL 。 必须至少有一个参数为非 NULL

如果为 pppDecoderRenderTargets 指定非 NULL 值, (接收呈现器目标图面) ,则 pNumSurfaces 不能为 NULL,因为它接收 pppDecoderRenderTargets 中返回的数组的大小。

要求

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

另请参阅

DirectX 视频加速 2.0

IDirectXVideoDecoder