PFND3D11_1DDI_VIDEODECODERGETHANDLE callback function (d3d10umddi.h)

Returns the driver's handle for a video decoder that can be used by the application to configure content protection.

Syntax

PFND3D11_1DDI_VIDEODECODERGETHANDLE Pfnd3d111DdiVideodecodergethandle;

HRESULT Pfnd3d111DdiVideodecodergethandle(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HDECODE unnamedParam2,
  HANDLE *pContentProtectionHandle
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

hDecoder [in]

A handle to the video decoder object that was created through a call to the CreateVideoDecoder function.

pContentProtectionHandle

A pointer to the handle.

Return value

VideoDecoderGetHandle returns one of the following values:

Return code Description
S_OK The handle was returned successfully.
D3DDDIERR_DEVICEREMOVED The graphics adapter was removed.
E_OUTOFMEMORY Memory was not available to complete the operation.

Remarks

The VideoDecoderGetHandle function returns a driver handle for the video decoder. This handle can be used by the application to associate the decoder with a cryptographic session over the authenticated channel.

This function allows the driver to define its own handle to its state data for the video decoder. This bypasses any handle mapping that may be performed by the Microsoft Direct3D runtime.

Note  Drivers can return the same handle in the pHandle parameter that was passed in the hDecoder parameter.
 

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Desktop
Header d3d10umddi.h (include D3d10umddi.h)

See also

CreateVideoDecoder

D3D11_1DDIARG_VIDEODECODEREXTENSION