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

  • Статья

Функция StartSessionKeyRefresh возвращает случайное число, которое функция FinishSessionKeyRefresh драйвера впоследствии использует для выполнения монопольной операции ИЛИ (XOR) с ключом сеанса.

Синтаксис

PFND3DDDI_STARTSESSIONKEYREFRESH Pfnd3dddiStartsessionkeyrefresh;

HRESULT Pfnd3dddiStartsessionkeyrefresh(
  HANDLE hDevice,
  const D3DDDIARG_STARTSESSIONKEYREFRESH *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in, out]

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

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

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

Код возврата Описание
S_OK Случайное число успешно возвращается.
D3DDDIERR_NOTAVAILABLE Драйвер не поддерживает функцию StartSessionKeyRefresh.

Комментарии

Оборудование и драйвер могут при необходимости поддерживать StartSessionKeyRefresh для всех типов шифрования.

Когда среда выполнения Direct3D вызывает функцию StartSessionKeyRefresh драйвера, драйвер создает и сохраняет случайное число и возвращает случайное число в буфере, на который указывает элемент pRandomNumber структуры D3DDDIARG_STARTSESSIONKEYREFRESH .

Когда впоследствии среда выполнения вызывает функцию FinishSessionKeyRefresh драйвера, драйвер выполняет операцию XOR случайного числа с ключом сеанса.

Требования

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

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

D3DDDIARG_STARTSESSIONKEYREFRESH

FinishSessionKeyRefresh