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;如果序列号不大于在上一次调用中指定的序列号，或者序列号尚未初始化（最后一个规则的例外是初始化调用本身）。
驱动程序应复制输出缓冲区结构中的输入数据，并且应将输出结构与当前处理 Output Protection Manager （OPM） 查询的方式相同。
除了应用程序错误地指定了太小的输出缓冲区的情况外，驱动程序应始终将返回代码放在输出结构中。 因此，应用程序具有用于确定返回代码的安全机制。
ConfigureAuthenticatedChannel 根据输入结构中指定的每个 GUID 执行不同的作。 如果输入缓冲区大小与为指定的 GUID 定义的大小不匹配，驱动程序应失败。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从 Windows 7作系统开始，支持 ConfigureAuthenticatedChannel。 |
| 目标平台 | 桌面 |
| 标头 | d3dumddi.h （包括 D3dumddi.h） |