функция обратного вызова 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 не удалось выделить необходимую память для завершения. |
Замечания
Входной буфер содержит код проверки подлинности сообщения в режиме CBC (OMAC), который драйвер должен пройти проверку подлинности. Входной буфер также содержит дескриптор драйвера к каналу с проверкой подлинности, порядковым номером и GUID, указывающим тип конфигурации.
Драйвер должен завершиться ошибкой ConfigureAuthenticatedChannel, если входной OMAC не совпадает, если номер последовательности не превышает порядковый номер, указанный в предыдущем вызове, или если номер последовательности еще не инициализирован (исключение для этого последнего правила является для самого вызова инициализации).
Драйвер должен дублировать входные данные в структуре выходного буфера и подписывать структуру выходных данных идентично тому, как она обрабатывает запросы Output Protection Manager (OPM).
За исключением тех ситуаций, в которых приложение неправильно указывает выходной буфер, который слишком мал, драйвер всегда должен размещать код возврата в выходной структуре. Поэтому приложение имеет безопасный механизм для определения возвращаемого кода.
ConfigureAuthenticatedChannel выполняет различные операции в зависимости от каждого из следующих идентификаторов GUID, указанных в входной структуре. Драйвер должен завершиться ошибкой, если размер входного буфера не соответствует размеру, определенному для указанного GUID.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | ConfigureAuthenticatedChannel поддерживается начиная с операционной системы Windows 7. |
| целевая платформа | Настольный |
| заголовка | d3dumddi.h (include D3dumddi.h) |