Skip to content

Latest commit

 

History

History
86 lines (63 loc) · 3.47 KB

nc-d3dumddi-pfnd3dddi_startsessionkeyrefresh.md

File metadata and controls

86 lines (63 loc) · 3.47 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:d3dumddi.PFND3DDDI_STARTSESSIONKEYREFRESH
PFND3DDDI_STARTSESSIONKEYREFRESH (d3dumddi.h)
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.
display\startsessionkeyrefresh.htm
display
05/10/2018
PFND3DDDI_STARTSESSIONKEYREFRESH callback function
PFND3DDDI_STARTSESSIONKEYREFRESH, PFND3DDDI_STARTSESSIONKEYREFRESH callback, StartSessionKeyRefresh, StartSessionKeyRefresh callback function [Display Devices], UserModeDisplayDriver_Functions_c68a1081-f350-4439-8c1c-91d9c54469bd.xml, d3dumddi/StartSessionKeyRefresh, display.startsessionkeyrefresh
d3dumddi.h
D3dumddi.h
Desktop
StartSessionKeyRefresh is supported beginning with the Windows 7 operating system.
Windows
PFND3DDDI_STARTSESSIONKEYREFRESH
d3dumddi/PFND3DDDI_STARTSESSIONKEYREFRESH
APIRef
kbSyntax
UserDefined
d3dumddi.h
PFND3DDDI_STARTSESSIONKEYREFRESH

PFND3DDDI_STARTSESSIONKEYREFRESH callback function

-description

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.

-parameters

-param hDevice

A handle to the display device (graphics context).

-param unnamedParam2

pData [in, out]

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

-returns

StartSessionKeyRefresh returns one of the following values:

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

-see-also

D3DDDIARG_STARTSESSIONKEYREFRESH

FinishSessionKeyRefresh