IDirect3DCryptoSession9::StartSessionKeyRefresh method (d3d9.h)

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

See also

GPU-Based Content Protection

IDirect3DCryptoSession9