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

Статья
03/08/2023

Функция ConfigureAuthenticatedChannel задает состояние в канале, прошедшем проверку подлинности.

Синтаксис

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;

HRESULT Pfnd3dddiConfigureauthenicatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Параметры

hDevice

Дескриптор устройства отображения (графический контекст).

unnamedParam2

pData [in, out]

Указатель на структуру D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL , описывающую настройку канала с проверкой подлинности. Эта структура содержит входной буфер, описывающий настройку канала, прошедшего проверку подлинности, и выходной буфер со сведениями о конфигурации.

Возвращаемое значение

ConfigureAuthenticatedChannel возвращает одно из следующих значений:

Код возврата	Описание
S_OK	Канал, прошедший проверку подлинности, успешно настроен.
E_OUTOFMEMORY	ConfigureAuthenticatedChannel не удалось выделить необходимую память для ее завершения.

Входной буфер содержит код проверки подлинности сообщения (OMAC) в режиме CBC, который должен пройти драйвер. Входной буфер также содержит дескриптор драйвера для канала, прошедшего проверку подлинности, порядковый номер и GUID, указывающий тип конфигурации.

Драйвер должен завершиться сбоем ConfigureAuthenticatedChannel , если входные данные OMAC не совпадают, если порядковый номер не больше порядкового номера, указанного в предыдущем вызове, или если порядковый номер еще не инициализирован (исключением из этого последнего правила является сам вызов инициализации).

Драйвер должен дублировать входные данные в структуре выходного буфера и подписывать структуру выходных данных так же, как он в настоящее время обрабатывает запросы диспетчера защиты вывода (OPM).

За исключением ситуаций, когда приложение неправильно указывает слишком маленький выходной буфер, драйвер всегда должен помещать код возврата в структуру вывода. Таким образом, приложение имеет безопасный механизм для определения кода возврата.

ConfigureAuthenticatedChannel выполняет различные операции в зависимости от каждого из следующих идентификаторов GUID, указанных во входной структуре. Драйвер должен завершиться ошибкой, если размер входного буфера не соответствует размеру, определенному для указанного GUID.

Требования

Требование	Значение
Минимальная версия клиента	ConfigureAuthenticatedChannel поддерживается начиная с операционной системы Windows 7.
Целевая платформа	Персональный компьютер
Верхняя часть	d3dumddi.h (включая D3dumddi.h)

См. также раздел

D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL