Edit

PFND3D11_1DDI_STARTSESSIONKEYREFRESH callback function (d3d10umddi.h)

  • Article

Gets a random number that can be used to refresh the session key.

Syntax

PFND3D11_1DDI_STARTSESSIONKEYREFRESH Pfnd3d111DdiStartsessionkeyrefresh;

void Pfnd3d111DdiStartsessionkeyrefresh(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HCRYPTOSESSION hCryptoSession,
  UINT RandomNumberSize,
  VOID *pRandomNumber
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

hCryptoSession

A handle to the cryptographic session object that was created through a call to the CreateCryptoSession function.

RandomNumberSize

The size, in bytes, of the number in the buffer that is referenced by the pRandomNumber parameter.

pRandomNumber

A pointer to a buffer that contains the status sequence number for the random start.

Return value

None

Remarks

The hardware and driver can optionally support StartSessionKeyRefresh for all cryptographic types.

When the Microsoft Direct3D runtime calls the driver's StartSessionKeyRefresh function, the driver generates and saves a random number and returns it in the buffer that the pRandomNumber parameter points to.

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

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Desktop
Header d3d10umddi.h (include D3d10umddi.h)

See also

CreateCryptoSession

FinishSessionKeyRefresh