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

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

  • Статья

Функция CreateAuthenticatedChannel создает канал, который среда выполнения Microsoft Direct3D и драйвер могут использовать для установки и запроса защиты.

Синтаксис

PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;

HRESULT Pfnd3dddiCreateauthenticatedchannel(
  HANDLE hDevice,
  D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in, out]

Указатель на структуру D3DDDIARG_CREATEAUTHENTICATEDCHANNEL . Во входных данных эта структура содержит сведения, которые может использовать драйвер. В выходных данных драйвер указывает сведения в структуре, которую может использовать среда выполнения Direct3D.

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

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

Код возврата Описание
S_OK Канал успешно создан.
E_OUTOFMEMORY CreateAuthenticatedChannel не удалось выделить необходимую память для ее завершения.
D3DDDIERR_NOTAVAILABLE Драйвер не поддерживает тип канала, указанный в элементе ChannelType структуры D3DDDIARG_CREATEAUTHENTICATEDCHANNEL , на которую указывает параметр pData.

Комментарии

Среда выполнения передает дескриптор каналу, прошедшему проверку подлинности, который драйвер возвращает в элементе ChannelTypeструктуры D3DDDIARG_CREATEAUTHENTICATEDCHANNEL во всех последующих вызовах, требующих дескриптора.

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

Требования

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

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

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL