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) |