функция обратного вызова PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL (d3d10umddi.h)

Статья
08/07/2023

Создает объект канала, прошедший проверку подлинности. Реализовано драйвером отображения windows Display Driver Model (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

Поделиться через