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) |