PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL回调函数 (d3d10umddi.h)

创建经过身份验证的通道对象。 由 Windows 显示驱动程序模型 (WDDM) 1.2 或更高版本的用户模式显示驱动程序实现。

语法

PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;

HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
  D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
  D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}

参数

hDevice

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

pCreateData

指向 D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL 结构的指针。 此结构指定要创建的经过身份验证的通道的属性。

hAuthChannel

对经过身份验证的通道对象的驱动程序专用数据的句柄。 有关详细信息,请参阅“备注”部分。

hRTAuthChannel

驱动程序在调用 Direct3D 运行时时应使用的经过身份验证的通道对象的句柄。

返回值

返回以下值之一:

返回代码 说明
S_OK 已成功创建经过身份验证的通道。
D3DDDIERR_DEVICEREMOVED 图形适配器已删除。
E_OUTOFMEMORY 内存无法完成作。

言论

Direct3D 运行时调用 CreateAuthenticatedChannel(D3D11_1) 后调用驱动程序的 CalcPrivateAuthenticatedChannelSize,以确定驱动程序对经过身份验证的通道对象所需的专用数据的大小(以字节为单位)。 运行时为驱动程序分配此专用数据的内存。 驱动程序使用此内存来存储与身份验证通道对象相关的专用数据。

当运行时调用 CreateAuthenticatedChannel(D3D11_1)时,它将句柄传递给 hAuthChannel 参数中的专用数据内存。 此句柄实际上是指向内存的指针。

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

要求

要求 价值
最低支持的客户端 Windows 8
支持的最低服务器 Windows Server 2012
目标平台 桌面
标头 d3d10umddi.h (包括 D3d10umddi.h)

另请参阅

CalcPrivateAuthenticatedChannelSize

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange