функция обратного вызова PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL (d3d10umddi.h)
Создает объект канала, прошедший проверку подлинности. Реализовано драйвером отображения windows Display Driver Model (WDDM) 1.2 или более поздней версии.
Синтаксис
PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;
HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
D3D10DDI_HDEVICE hDevice,
D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}
Параметры
hDevice
Дескриптор устройства отображения (графический контекст).
pCreateData
Указатель на структуру D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL . Эта структура определяет атрибуты канала, прошедшего проверку подлинности, который необходимо создать.
hAuthChannel
Дескриптор личных данных драйвера для объекта канала, прошедшего проверку подлинности. Дополнительные сведения см. в разделе «Примечания».
hRTAuthChannel
Дескриптор объекта канала, прошедшего проверку подлинности, который драйвер должен использовать при обратном вызове в среду выполнения Direct3D.
Возвращаемое значение
Возвращает одно из следующих значений:
Код возврата | Описание |
---|---|
S_OK | Канал, прошедший проверку подлинности, успешно создан. |
D3DDDIERR_DEVICEREMOVED | Графический адаптер удален. |
E_OUTOFMEMORY | Память не была доступна для завершения операции. |
Комментарии
Среда выполнения Direct3D вызывает CreateAuthenticatedChannel(D3D11_1) после вызова драйвера CalcPrivateAuthenticatedChannelSize , чтобы определить размер частных данных в байтах, необходимый драйверу для объекта канала, прошедшего проверку подлинности. Среда выполнения выделяет память для этих личных данных для драйвера. Драйвер использует эту память для хранения личных данных, связанных с объектом канала проверки подлинности.
Когда среда выполнения вызывает CreateAuthenticatedChannel(D3D11_1), она передает дескриптор в частную память данных в параметре hAuthChannel . Этот дескриптор фактически является указателем на память.
Драйвер должен отслеживать дескриптор устройства отображения, который использовался для создания канала, прошедшего проверку подлинности. Драйвер должен завершиться ошибкой всех последующих вызовов, использующих этот созданный канал с проверкой подлинности, например NegotiateAuthenticatedChannelKeyExchange, если устройство отображения, указанное в этих вызовах, отличается от устройства отображения, которое использовалось для создания канала, прошедшего проверку подлинности.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 8 |
Минимальная версия сервера | Windows Server 2012 |
Целевая платформа | Персональный компьютер |
Верхняя часть | d3d10umddi.h (включая D3d10umddi.h) |
См. также раздел
CalcPrivateAuthenticatedChannelSize
CreateAuthenticatedChannel(D3D11_1)