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