ID3D11VideoContext::StartSessionKeyRefresh method (d3d11.h)

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

Syntax

void StartSessionKeyRefresh(
  [in]  ID3D11CryptoSession *pCryptoSession,
  [in]  UINT                RandomNumberSize,
  [out] void                *pRandomNumber
);

Parameters

[in] pCryptoSession

A pointer to the ID3D11CryptoSession interface.

[in] RandomNumberSize

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

[out] pRandomNumber

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

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 ID3D11VideoContext::FinishSessionKeyRefresh.

To query whether the driver supports this method, call ID3D11VideoDevice::GetContentProtectionCaps and check for the D3D11_CONTENT_PROTECTION_CAPS_FRESHEN_SESSION_KEY capabilities flag.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header d3d11.h

See also

ID3D11VideoContext