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

Статья
08/07/2023

Функция QueryAuthenticatedChannel запрашивает проверенный канал для получения сведений о возможностях и состоянии.

Синтаксис

PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;

HRESULT Pfnd3dddiQueryauthenticatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in, out]

Указатель на структуру D3DDDIARG_QUERYAUTHENTICATEDCHANNEL , которая описывает сведения о канале, прошедшем проверку подлинности, для запроса. Эта структура содержит входной буфер, описывающий запрос, и выходной буфер для возврата запрашиваемой информации.

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

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

Код возврата	Описание
S_OK	Успешно выполнен запрос к каналу, прошедшему проверку подлинности.
E_OUTOFMEMORY	QueryAuthenticatedChannel не удалось выделить необходимую память для его завершения.

Входной буфер содержит дескриптор драйвера для канала, прошедшего проверку подлинности, порядковый номер и GUID, указывающий тип запроса. Драйвер должен завершить все запросы, если драйвер ранее не инициализировал порядковый номер с помощью вызова функции ConfigureAuthenticatedChannel . Драйвер также должен завершить запрос ошибкой, если порядковый номер не превышает порядковый номер предыдущего вызова запроса.

Драйвер должен дублировать входные данные в структуре выходного буфера и подписывать структуру выходных данных так же, как в настоящее время обрабатывает запросы диспетчера защиты вывода (OPM).

За исключением ситуаций, когда приложение неправильно указывает слишком маленький выходной буфер, драйвер всегда должен помещать код возврата в структуру вывода. Таким образом, приложение имеет безопасный механизм для определения кода возврата.

QueryAuthenticatedChannel выполняет различные операции в зависимости от каждого из следующих идентификаторов GUID, указанных во входной структуре. Драйвер должен завершиться ошибкой, если размеры входных и выходных буферов не соответствуют размерам, определенным для указанного GUID.

Требования

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

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

НастройкаAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL

Поделиться через