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