PFND3DDDI_CREATECRYPTOSESSION callback function (d3dumddi.h)

The CreateCryptoSession function creates a crypto session that the Direct3D runtime uses to manage a session key and to perform crypto operations into and out of protected memory.

Syntax

PFND3DDDI_CREATECRYPTOSESSION Pfnd3dddiCreatecryptosession;

HRESULT Pfnd3dddiCreatecryptosession(
  HANDLE hDevice,
  D3DDDIARG_CREATECRYPTOSESSION *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

pData [in, out]

A pointer to a D3DDDIARG_CREATECRYPTOSESSION structure. On input, this structure contains information that the driver can use. On output, the driver specifies information in the structure that the Microsoft Direct3D runtime can use.

Return value

CreateCryptoSession returns one of the following values:

Return code Description
S_OK The crypto session is successfully created.
E_OUTOFMEMORY CreateCryptoSession could not allocate the required memory for it to complete.
D3DDDIERR_NOTAVAILABLE The driver does not support the GUID that is specified in the CryptoTypemember of the D3DDDIARG_CREATECRYPTOSESSION structure or the NULL_GUID (all zeros) is specified in the CryptoTypemember.
D3DDDIERR_UNSUPPORTEDCRYPTO The driver does not support the crypto type for the specified decode type.

Remarks

If the DecodeProfile member of the D3DDDIARG_CREATECRYPTOSESSION structure is NULL_GUID, the crypto session will not be used for DirectX Video Acceleration (DirectX VA) decoding. If DecodeProfile is not NULL GUID, the driver should fail with D3DDDIERR_UNSUPPORTEDCRYPTO if the crypto type in the CryptoType member is not supported by the decode profile.

The driver returns a handle for the crypto session in the hCryptoSession member of D3DDDIARG_CREATECRYPTOSESSION that the runtime passes in all subsequent crypto session calls (for example, CryptoSessionKeyExchange).

The driver must keep track of the display device (hDevice) that was used to create the crypto session. The driver should fail all subsequent calls that use this created crypto session if the display device that is specified in those calls is different from the display device that was used to create the crypto session.

Requirements

Requirement Value
Minimum supported client Supported starting with Windows 7.
Target Platform Desktop
Header d3dumddi.h (include D3dumddi.h)

See also

CryptoSessionKeyExchange

D3DDDIARG_CREATECRYPTOSESSION