PFND3DDDI_FINISHSESSIONKEYREFRESH callback function

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

Syntax

PFND3DDDI_FINISHSESSIONKEYREFRESH Pfnd3dddiFinishsessionkeyrefresh;

HRESULT Pfnd3dddiFinishsessionkeyrefresh(
  HANDLE hDevice,
  const D3DDDIARG_FINISHSESSIONKEYREFRESH *Arg2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

Arg2

pData [in]

A pointer to a D3DDDIARG_FINISHSESSIONKEYREFRESH structure that describes the session.

Return Value

FinishSessionKeyRefresh returns one of the following values:

Return code Description
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

   
Minimum supported client The FinishSessionKeyRefresh function is supported beginning with the Windows 7 operating system.
Target Platform Desktop
Header d3dumddi.h (include D3dumddi.h)

See Also

D3DDDIARG_FINISHSESSIONKEYREFRESH

D3DDDIARG_STARTSESSIONKEYREFRESH

StartSessionKeyRefresh