PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL回调函数 (d3dumddi.h)

  • 项目

ConfigureAuthenticatedChannel 函数设置经过身份验证的通道中的状态。

语法

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;

HRESULT Pfnd3dddiConfigureauthenicatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

参数

hDevice

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

unnamedParam2

pData [in， out]

指向描述如何配置经过身份验证的通道的 D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL 结构的指针。 此结构包含一个描述如何配置经过身份验证的通道的输入缓冲区，以及一个包含配置信息的输出缓冲区。

返回值

ConfigureAuthenticatedChannel 返回以下值之一：

返回代码 说明
S_OK 已成功配置经过身份验证的通道。
E_OUTOFMEMORY ConfigureAuthenticatedChannel 无法分配完成所需的内存。

注解

输入缓冲区包含一个单键密码块链 (CBC) 模式消息身份验证代码， (驱动程序必须进行身份验证的 OMAC) 。 输入缓冲区还包含驱动程序对经过身份验证的通道的句柄、序列号和指示配置类型的 GUID。

如果输入 OMAC 不匹配，如果序列号不大于在上一次调用中指定的序列号，或者如果序列号尚未初始化， (此最后一个规则的例外是初始化调用本身) ，驱动程序应会失败 ConfigureAuthenticatedChannel 。

驱动程序应复制输出缓冲区结构中的输入数据，并应以与当前处理 输出保护管理器 (OPM) 查询的方式相同的方式对输出结构进行签名。

除了应用程序错误地指定输出缓冲区太小的情况外，驱动程序应始终将返回代码放在输出结构中。 因此，应用程序具有用于确定返回代码的安全机制。

ConfigureAuthenticatedChannel 根据输入结构中指定的以下每个 GUID 执行不同的操作。 如果输入缓冲区大小与为指定 GUID 定义的大小不匹配，驱动程序应会失败。

要求

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

另请参阅

D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL