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