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

  • Статья

Функция AuthenticatedChannelKeyExchange согласовывает ключ сеанса.

Синтаксис

PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3dddiAuthenticatedchannelkeyexchange;

HRESULT Pfnd3dddiAuthenticatedchannelkeyexchange(
  HANDLE hDevice,
  D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in, out]

Указатель на структуру D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE , описывающую буфер, содержащий ключ сеанса, который используется каналом с проверкой подлинности.

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

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

Код возврата Описание
S_OK Ключ сеанса успешно согласован.
E_OUTOFMEMORY AuthenticatedChannelKeyExchange не удалось выделить необходимую память для ее завершения.

Комментарии

Элемент pData в структуре D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE указывает на буфер, содержащий секретный ключ, который приложение ранее было зашифровано RSAES-OAEP с помощью открытого ключа из сертификата канала, прошедшего проверку подлинности драйвера. Фактический размер буфера составляет 256 байт. Этот обмен аналогичен обмену ключами диспетчера защиты вывода (OPM), за исключением того, что буфер OPM содержит дополнительные данные, кроме сеансового ключа. Для канала, прошедшего проверку подлинности, можно использовать тот же сертификат, который используется для обмена ключами OPM.

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

Требования

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

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

D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE