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

Статья
08/07/2023

Обрабатывает запрос от приложения для настройки канала, прошедшего проверку подлинности, для защиты содержимого. Реализовано драйвером отображения windows Display Driver Model (WDDM) 1.2 или более поздней версии.

Синтаксис

PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Pfnd3d111DdiConfigureauthenticatedchannel;

HRESULT Pfnd3d111DdiConfigureauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
  UINT InputDataSize,
  const VOID *pInputData,
  D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT *pOutputData
)
{...}

Параметры

hDevice

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

hCAuthChannel

Дескриптор объекта канала, прошедшего проверку подлинности, который был создан с помощью вызова функции CreateAuthenticatedChannel(D3D11_1).

InputDataSize

Размер (в байтах) массива, заданного параметром pInputData .

pInputData

Указатель на массив байтов, содержащий входные данные для команды. Дополнительные сведения см. в разделе «Примечания».

pOutputData

Указатель на структуру D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT . Дополнительные сведения см. в разделе «Примечания».

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

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

Код возврата	Описание
S_OK	Канал, прошедший проверку подлинности, успешно настроен.
E_FAIL	Драйвер мини-порта дисплея не поддерживает указанную команду
E_INVALIDARG	Параметры были проверены и определены как неверные.
E_OUTOFMEMORY	Память не была доступна для завершения операции.

D3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION
D3D11_1DDI_AUTHENTICATED_CONFIGURE_ACCESSIBLE_ENCRYPTION D3D11_1DDI_AUTHENTICATED_CONFIGURE_ENCRYPTION_WHEN_ACCESSIBLE_GUID
D3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE D3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE_GUID
D3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION
D3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE

Структура D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT содержит основанный на AES код проверки подлинности сообщений CBC (OMAC) данных. Драйвер мини-порта дисплея должен вычислить собственный OMAC по данным для проверки подлинности данных. Эта входная структура также содержит дескриптор драйвера для канала, прошедшего проверку подлинности, порядковый номер и GUID, указывающий тип конфигурации.

Драйвер мини-порта дисплея выполняет следующие действия при инициализации структуры D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT :

Драйвер должен скопировать входные данные в структуру D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT .
Драйвер должен задать члену ReturnCode тот же код возврата, который будет возвращен для вызова ConfigureAuthenticatedChannel(D3D11_1). Это обеспечивает приложению безопасный механизм доступа к коду возврата.
Драйвер устанавливает элемент omac равным нулю, а затем вычисляет OMAC для данных в структуре. Затем драйвер задает член omac для вычисляемого OMAC.

Драйвер мини-порта дисплея должен возвращать E_INVALIDARG для вызова ConfigureAuthenticatedChannel при следующих условиях:

Элемент omac структурыD3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT не соответствует OMAC, рассчитанной драйвером.
Порядковый номер не больше, чем порядковый номер, указанный в предыдущем вызове конфигурации.
Порядковый номер еще не инициализирован вызовом функции ConfigureAuthenticatedChannel(D3D11_1).
Параметр InputDataSize меньше размера структуры D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT плюс размер структуры, указанной в D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT. ConfigureTypemember.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Персональный компьютер
Верхняя часть	d3d10umddi.h (включая D3d10umddi.h)

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

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT

Share via