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 运行时在调用驱动程序的 CalcPrivateAuthenticatedChannelSize 后调用 CreateAuthenticatedChannel (D3D11_1) ，以确定驱动程序为经过身份验证的通道对象所需的专用数据的大小（以字节为单位）。 运行时为驱动程序分配此专用数据的内存。 驱动程序使用此内存来存储与身份验证通道对象相关的专用数据。

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

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

要求

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

另请参阅

CalcPrivateAuthenticatedChannelSize

CreateAuthenticatedChannel (D3D11_1)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange