IDirect3DCryptoSession9::StartSessionKeyRefresh method

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

Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Header	D3d9.h