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

Статья
02/06/2025

Функция 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 ChannelType член структуры D3DDDIARG_CREATEAUTHENTICATEDCHANNEL во всех последующих вызовах, требующих дескриптора.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	CreateAuthenticatedChannel поддерживается начиная с операционной системы Windows 7.
целевая платформа	Настольный
заголовка	d3dumddi.h (include D3dumddi.h)

См. также

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL

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