функция обратного вызова 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) |