PFND3DDDI_STARTSESSIONKEYREFRESH callback function

The StartSessionKeyRefresh function returns a random number that the driver's FinishSessionKeyRefresh function subsequently uses to perform an exclusive OR operation (XOR) with the session key.

Syntax


PFND3DDDI_STARTSESSIONKEYREFRESH StartSessionKeyRefresh;

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

Parameters

hDevice [in]

A handle to the display device (graphics context).

pData [in, out]

A pointer to a D3DDDIARG_STARTSESSIONKEYREFRESH structure that contains information about the random number.

Return value

StartSessionKeyRefresh returns one of the following values:

Return codeDescription
S_OK

The random number is successfully returned.

D3DDDIERR_NOTAVAILABLE

The driver does not support the StartSessionKeyRefresh function.

 

Remarks

The hardware and driver can optionally support StartSessionKeyRefresh 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

Target platform

Desktop

Version

StartSessionKeyRefresh is supported beginning with the Windows 7 operating system.

Header

D3dumddi.h (include D3dumddi.h)

See also

D3DDDIARG_STARTSESSIONKEYREFRESH
FinishSessionKeyRefresh

 

 

Send comments about this topic to Microsoft

Show: