VideoDecoderGetHandle function

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

Syntax


HRESULT APIENTRY* VideoDecoderGetHandle(
  _In_  D3D10DDI_HDEVICE   hDevice,
  _In_  D3D11_1DDI_HDECODE hDecoder,
  _Out_ HANDLE             *pContentProtectionHandle
);

Parameters

hDevice [in]

A handle to the display device (graphics context).

hDecoder [in]

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

pContentProtectionHandle [out]

A pointer to the handle.

Return value

VideoDecoderGetHandle returns one of the following values:

Return codeDescription
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

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

 

 

Send comments about this topic to Microsoft

Show: