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 函数初始化序列号，则驱动程序应会失败所有查询。 如果序列号不大于上一个查询调用的序列号，则驱动程序还应使查询失败。
驱动程序应复制输出缓冲区结构中的输入数据，并应以与当前处理 输出保护管理器 (OPM) 查询的方式相同的方式对输出结构进行签名。
除了应用程序错误地指定输出缓冲区太小的情况外，驱动程序应始终将返回代码放在输出结构中。 因此，应用程序具有用于确定返回代码的安全机制。
QueryAuthenticatedChannel 根据输入结构中指定的以下每个 GUID 执行不同的操作。 如果输入和输出缓冲区大小与为指定 GUID 定义的大小不匹配，驱动程序应会失败。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 从 Windows 7 操作系统开始，支持 QueryAuthenticatedChannel。 |
| 目标平台 | 桌面 |
| 标头 | d3dumddi.h (包括 D3dumddi.h) |