PFND3DDDI_QUERYAUTHENTICATEDCHANNEL回调函数 （d3dumddi.h）
QueryAuthenticatedChannel 函数查询经过身份验证的通道以获取功能和状态信息。
语法
PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;
HRESULT Pfnd3dddiQueryauthenticatedchannel(
HANDLE hDevice,
const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
参数
hDevice
显示设备的句柄（图形上下文）。
unnamedParam2
pData [in， out]
指向描述要查询的经过身份验证通道信息的 D3DDDIARG_QUERYAUTHENTICATEDCHANNEL 结构的指针。 此结构包含一个输入缓冲区，该缓冲区描述查询和输出缓冲区以返回查询的信息。
返回值
QueryAuthenticatedChannel 返回以下值之一：
| 返回代码 | 描述 |
|---|---|
| S_OK | 已成功查询经过身份验证的通道。 |
| E_OUTOFMEMORY | QueryAuthenticatedChannel 无法为其分配完成所需的内存。 |
言论
输入缓冲区包含经过身份验证的通道的驱动程序句柄、序列号和指示查询类型的 GUID。 如果驱动程序以前未通过调用其 ConfigureAuthenticatedChannel 函数初始化序列号，驱动程序应会失败所有查询。 如果序列号不大于上一查询调用的序列号，驱动程序还应失败查询。
驱动程序应复制输出缓冲区结构中的输入数据，并且应将输出结构与当前处理 Output Protection Manager （OPM） 查询的方式相同。
除了应用程序错误地指定了太小的输出缓冲区的情况外，驱动程序应始终将返回代码放在输出结构中。 因此，应用程序具有用于确定返回代码的安全机制。
QueryAuthenticatedChannel 根据输入结构中指定的每个 GUID 执行不同的作。 如果输入和输出缓冲区大小与为指定的 GUID 定义的大小不匹配，驱动程序应失败。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从 Windows 7作系统开始，支持 QueryAuthenticatedChannel。 |
| 目标平台 | 桌面 |
| 标头 | d3dumddi.h （包括 D3dumddi.h） |