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