IDirect3DCryptoSession9::StartSessionKeyRefresh method (d3d9.h)

Article
02/22/2024

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

Syntax

HRESULT StartSessionKeyRefresh(
  VOID *pRandomNumber,
  UINT RandomNumberSize
);

Parameters

pRandomNumber

A pointer to a byte array that receives a random number.

RandomNumberSize

The size of the pRandomNumber array, in bytes. The size should match the size of the session key.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

To generate a new session key, perform a bitwise XOR between the previous session key and the random number. The new session key does not take affect until the application calls IDirect3DCryptoSession9::FinishSessionKeyRefresh.

If the driver supports this method, the driver sets the D3DCPCAPS_FRESHENSESSIONKEY capabilities flag in the IDirect3DDevice9Video::GetContentProtectionCaps method.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	d3d9.h