PFND3DDDI_GETENCRYPTIONBLTKEY callback function (d3dumddi.h)

The GetEncryptionBltKey function returns the key that is used to decrypt the data that the driver's EncryptionBlt function returns.

Syntax

PFND3DDDI_GETENCRYPTIONBLTKEY Pfnd3dddiGetencryptionbltkey;

HRESULT Pfnd3dddiGetencryptionbltkey(
  HANDLE hDevice,
  const D3DDDIARG_GETENCRYPTIONBLTKEY *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

pData [in, out]

A pointer to a D3DDDIARG_GETENCRYPTIONBLTKEY structure that describes the key for an encrypted session.

Return value

GetEncryptionBltKey returns one of the following values:

Return code Description
S_OK The key for an encrypted session is successfully retrieved.
D3DDDIERR_NOTAVAILABLE The driver does not support the GetEncryptionBltKey function.

Remarks

The hardware and driver can optionally support the GetEncryptionBltKey function for all crypto types.

Each time the Direct3D runtime calls the driver's GetEncryptionBltKey function, the driver should generate a new read-back key. If the driver's CreateCryptoSession function previously created the encryption session with the CryptoType member of the D3DDDIARG_CREATECRYPTOSESSION structure set to D3DCRYPTOTYPE_AES128_CTR, the driver and hardware should encrypt the read-back key with the session key.

Requirements

Requirement Value
Minimum supported client GetEncryptionBltKey is supported beginning with the Windows 7 operating system.
Target Platform Desktop
Header d3dumddi.h (include D3dumddi.h)

See also

CreateCryptoSession

D3DDDIARG_CREATECRYPTOSESSION

D3DDDIARG_GETENCRYPTIONBLTKEY

EncryptionBlt