// d3dumddi.h
PFND3DDDI_STARTSESSIONKEYREFRESH Pfnd3dddiStartsessionkeyrefresh;
HRESULT Pfnd3dddiStartsessionkeyrefresh(
HANDLE hDevice,
const D3DDDIARG_STARTSESSIONKEYREFRESH *unnamedParam2
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
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.
hDeviceA handle to the display device (graphics context).
unnamedParam2pData [in, out]
A pointer to a D3DDDIARG_STARTSESSIONKEYREFRESH structure that contains information about the random number.
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. |
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.
D3DDDIARG_STARTSESSIONKEYREFRESH