PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL función de devolución de llamada (d3d10umddi.h)

Crea un objeto de canal autenticado. Implementado por un controlador de pantalla de Windows Display Driver Model (WDDM) 1.2 o posterior.

Sintaxis

PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;

HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
  D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
  D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}

Parámetros

hDevice

Identificador del dispositivo de visualización (contexto de gráficos).

pCreateData

Puntero a una estructura de D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL . Esta estructura especifica los atributos del canal autenticado que se va a crear.

hAuthChannel

Identificador de los datos privados del controlador para el objeto de canal autenticado. Para obtener más información, vea la sección Comentarios.

hRTAuthChannel

Identificador del objeto de canal autenticado que el controlador debe usar cuando llama de nuevo al tiempo de ejecución de Direct3D.

Valor devuelto

Devuelve uno de los valores siguientes:

Código devuelto	Descripción
S_OK	El canal autenticado se creó correctamente.
D3DDDIERR_DEVICEREMOVED	Se quitó el adaptador de gráficos.
E_OUTOFMEMORY	La memoria no estaba disponible para completar la operación.

Comentarios

El tiempo de ejecución de Direct3D llama a CreateAuthenticatedChannel(D3D11_1) después de llamar al CalcPrivateAuthenticatedChannelSize del controlador para determinar el tamaño en bytes de los datos privados que requiere el controlador para el objeto de canal autenticado. El tiempo de ejecución asigna la memoria para estos datos privados para el controlador. El controlador usa esta memoria para almacenar datos privados relacionados con el objeto de canal de autenticación.

Cuando el tiempo de ejecución llama a CreateAuthenticatedChannel(D3D11_1), pasa el identificador a la memoria de datos privadas en el parámetro hAuthChannel . Este identificador es realmente un puntero a la memoria.

El controlador debe realizar un seguimiento del identificador en el dispositivo de visualización que se usó para crear el canal autenticado. El controlador debe producir un error en todas las llamadas posteriores que usan este canal autenticado creado, como NegotiateAuthenticatedChannelKeyExchange, si el dispositivo para mostrar especificado en esas llamadas es diferente del dispositivo de visualización que se usó para crear el canal autenticado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Escritorio
Encabezado	d3d10umddi.h (incluya D3d10umddi.h)

Consulte también

CalcPrivateAuthenticatedChannelSize

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange