通过

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 成员中指定的通道类型。

言论

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

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

要求

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

另请参阅

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL