Blt
Expand Minimize

FinishSessionKeyRefresh routine

The FinishSessionKeyRefresh function indicates that all buffers from that point in time use the updated session key value.

Syntax


PFND3DDDI_FINISHSESSIONKEYREFRESH FinishSessionKeyRefresh;

__checkReturn HRESULT APIENTRY FinishSessionKeyRefresh(
  _In_  HANDLE hDevice,
  _In_  const D3DDDIARG_FINISHSESSIONKEYREFRESH *pData
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

pData [in]

A pointer to a D3DDDIARG_FINISHSESSIONKEYREFRESH structure that describes the session.

Return value

FinishSessionKeyRefresh returns one of the following values:

Return codeDescription
S_OK

The session is successfully updated.

D3DDDIERR_NOTAVAILABLE

The driver does not support the FinishSessionKeyRefresh function.

 

Remarks

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

When the Direct3D runtime calls the driver's StartSessionKeyRefresh function, the driver generates and saves a random number and returns the random number in the buffer that the pRandomNumber member of the D3DDDIARG_STARTSESSIONKEYREFRESH structure points to.

When the runtime subsequently calls the driver's FinishSessionKeyRefresh function, the driver performs an XOR operation of the random number with the session key.

Requirements

Version

The FinishSessionKeyRefresh function is supported beginning with the Windows 7 operating system.

Header

D3dumddi.h (include D3dumddi.h)

See also

D3DDDIARG_FINISHSESSIONKEYREFRESH
D3DDDIARG_STARTSESSIONKEYREFRESH
StartSessionKeyRefresh

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.