PFND3DDDI_SETDECODERENDERTARGET callback function

The SetDecodeRenderTarget function sets the render target surface for decoding operations.

Syntax


PFND3DDDI_SETDECODERENDERTARGET SetDecodeRenderTarget;

__checkReturn HRESULT APIENTRY SetDecodeRenderTarget(
  _In_       HANDLE                          hDevice,
  _In_ const D3DDDIARG_SETDECODERENDERTARGET *pData
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

pData [in]

A pointer to a D3DDDIARG_SETDECODERENDERTARGET structure that describes the decode render target surface.

Return value

SetDecodeRenderTarget returns one of the following values:

Return codeDescription
S_OK

The render target surface is successfully set.

E_OUTOFMEMORY

SetDecodeRenderTarget could not allocate the required memory for it to complete.

 

Remarks

The SetDecodeRenderTarget function can be called only outside of a DecodeBeginFrame/DecodeEndFrame block.

Decode render targets are always created atomically through calls to the CreateResource function, where all of the decode buffers are indexes within a single resource. All decode render targets are created by setting the D3DDDI_RESOURCEFLAGS.DecodeRenderTarget bit-field flag in the Flags member of the D3DDDIARG_CREATERESOURCE structure.

Requirements

Target platform

Desktop

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dumddi.h (include D3dumddi.h)

See also

CreateResource
D3DDDIARG_CREATERESOURCE
D3DDDIARG_SETDECODERENDERTARGET
D3DDDI_DEVICEFUNCS
D3DDDI_RESOURCEFLAGS
DecodeBeginFrame
DecodeEndFrame

 

 

Send comments about this topic to Microsoft

Show: