PFND3DDDI_CREATEAUTHENTICATEDCHANNEL回调函数 (d3dumddi.h)

  • 项目

CreateAuthenticatedChannel 函数创建一个通道，Microsoft Direct3D 运行时和驱动程序可以使用该通道来设置和查询保护。

语法

PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;

HRESULT Pfnd3dddiCreateauthenticatedchannel(
  HANDLE hDevice,
  D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

参数

hDevice

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

unnamedParam2

pData [in， out]

指向 D3DDDIARG_CREATEAUTHENTICATEDCHANNEL 结构的指针。 输入时，此结构包含驱动程序可以使用的信息。 在输出时，驱动程序在结构中指定 Direct3D 运行时可以使用的信息。

返回值

CreateAuthenticatedChannel 返回以下值之一：

返回代码 说明
S_OK 已成功创建通道。
E_OUTOFMEMORY CreateAuthenticatedChannel 无法分配完成所需的内存。
D3DDDIERR_NOTAVAILABLE 驱动程序不支持在 pData 参数指向的 D3DDDIARG_CREATEAUTHENTICATEDCHANNEL 结构的 ChannelType 成员中指定的通道类型。

注解

运行时将句柄传递给经过身份验证的通道，驱动程序在需要该句柄的所有后续调用中D3DDDIARG_CREATEAUTHENTICATEDCHANNEL结构的 ChannelType 成员中返回该通道。

驱动程序必须跟踪用于创建经过身份验证的通道的显示设备 (hDevice) 。 驱动程序应使使用此创建的经过身份验证的通道的所有后续调用失败 (例如，如果在这些调用中指定的显示设备与用于创建经过身份验证的通道的显示设备不同， 则 AuthenticatedChannelKeyExchange 函数) 。

要求

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

另请参阅

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL