Hardware Dev Center

Blt
Collapse the table of content
Expand the table of content
Espandi Riduci a icona

GetEncryptionBltKey routine

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

Syntax


PFND3DDDI_GETENCRYPTIONBLTKEY GetEncryptionBltKey;

__checkReturn HRESULT APIENTRY GetEncryptionBltKey(
  _In_          HANDLE                        hDevice,
  _Inout_ const D3DDDIARG_GETENCRYPTIONBLTKEY *pData
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

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

Target platform

Desktop

Version

GetEncryptionBltKey is supported beginning with the Windows 7 operating system.

Header

D3dumddi.h (include D3dumddi.h)

See also

CreateCryptoSession
D3DDDIARG_CREATECRYPTOSESSION
D3DDDIARG_GETENCRYPTIONBLTKEY
EncryptionBlt

 

 

Send comments about this topic to Microsoft

Mostra:
© 2015 Microsoft