PFND3DDDI_STARTSESSIONKEYREFRESH回调函数 (d3dumddi.h)

StartSessionKeyRefresh 函数返回一个随机数,驱动程序的 FinishSessionKeyRefresh 函数随后使用会话键执行独占 OR作(XOR)。

语法

PFND3DDDI_STARTSESSIONKEYREFRESH Pfnd3dddiStartsessionkeyrefresh;

HRESULT Pfnd3dddiStartsessionkeyrefresh(
  HANDLE hDevice,
  const D3DDDIARG_STARTSESSIONKEYREFRESH *unnamedParam2
)
{...}

参数

hDevice

显示设备的句柄(图形上下文)。

unnamedParam2

pData [in, out]

指向包含随机数信息的 D3DDDIARG_STARTSESSIONKEYREFRESH 结构的指针。

返回值

StartSessionKeyRefresh 返回以下值之一:

返回代码 描述
S_OK 随机数已成功返回。
D3DDDIERR_NOTAVAILABLE 驱动程序不支持 StartSessionKeyRefresh 函数。

言论

硬件和驱动程序可以选择为所有加密类型支持 StartSessionKeyRefresh

当 Direct3D 运行时调用驱动程序的 StartSessionKeyRefresh 函数时,驱动程序将生成并保存一个随机数,并在缓冲区中返回 pRandomNumberD3DDDIARG_STARTSESSIONKEYREFRESH 结构的成员指向的随机数。

当运行时随后调用驱动程序的 FinishSessionKeyRefresh 函数时,驱动程序将使用会话键执行随机数的 XOR作。

要求

要求 价值
最低支持的客户端 从 Windows 7作系统开始,支持 StartSessionKeyRefresh。
目标平台 桌面
标头 d3dumddi.h (包括 D3dumddi.h)

另请参阅

D3DDDIARG_STARTSESSIONKEYREFRESH

FinishSessionKeyRefresh