PFND3DDDI_STARTSESSIONKEYREFRESH回调函数 (d3dumddi.h)

  • 项目

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

语法

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 函数时，驱动程序生成并保存一个随机数，并在缓冲区中返回D3DDDIARG_STARTSESSIONKEYREFRESH结构的 pRandomNumber 成员指向的随机数。

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

要求

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

另请参阅

D3DDDIARG_STARTSESSIONKEYREFRESH

FinishSessionKeyRefresh