IDirectXVideoDecoder::GetCreationParameters method (dxva2api.h)

Retrieves the parameters that were used to create this device.

Syntax

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

Parameters

[out] pDeviceGuid

Receives the device GUID. This parameter can be NULL.

[out] pVideoDesc

Pointer to a DXVA2_VideoDesc structure that receives a description of the video format. This parameter can be NULL.

[out] pConfig

Pointer to a DXVA2_ConfigPictureDecode structure that receives the decoder configuration. This parameter can be NULL.

[out] pDecoderRenderTargets

Receives an array of IDirect3DSurface9 interface pointers. These pointers represent the decoder render targets. The method allocates the memory for the array and calls AddRef on each of the pointers. The caller must release the pointers and call CoTaskMemFree to free the memory for the array. This parameter can be NULL.

[out] pNumSurfaces

Receives the number of elements in the pppDecoderRenderTargets array. This parameter can be NULL.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Remarks

You can set any parameter to NULL if you are not interested in the result. At least one parameter must be non-NULL.

If you specify a non-NULL value for pppDecoderRenderTargets (to receive the render target surfaces), then pNumSurfaces cannot be NULL, because it receives the size of the array returned in pppDecoderRenderTargets.

Requirements

See also

DirectX Video Acceleration 2.0

IDirectXVideoDecoder