PFND3DDDI_CREATEAUTHENTICATEDCHANNEL función de devolución de llamada (d3dumddi.h)

  • Artículo

La función CreateAuthenticatedChannel crea un canal que el entorno de ejecución de Microsoft Direct3D y el controlador puede usar para establecer y consultar protecciones.

Sintaxis

PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;

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

Parámetros

hDevice

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

unnamedParam2

pData [in, out]

Puntero a una estructura de D3DDDIARG_CREATEAUTHENTICATEDCHANNEL . En la entrada, esta estructura contiene información que el controlador puede usar. En la salida, el controlador especifica información en la estructura que puede usar el entorno de ejecución de Direct3D.

Valor devuelto

CreateAuthenticatedChannel devuelve uno de los siguientes valores:

Código devuelto Descripción
S_OK El canal se crea correctamente.
E_OUTOFMEMORY CreateAuthenticatedChannel no pudo asignar la memoria necesaria para que se complete.
D3DDDIERR_NOTAVAILABLE El controlador no admite el tipo de canal especificado en el miembro ChannelType de la estructura D3DDDIARG_CREATEAUTHENTICATEDCHANNEL a la que apunta el parámetro pData.

Comentarios

El tiempo de ejecución pasa el identificador al canal autenticado que el controlador devuelve en el miembro ChannelType de la estructura D3DDDIARG_CREATEAUTHENTICATEDCHANNEL en todas las llamadas posteriores que requieren el identificador.

El controlador debe realizar un seguimiento del dispositivo de visualización (hDevice) que se usó para crear el canal autenticado. El controlador debe producir un error en todas las llamadas posteriores que usen este canal autenticado creado (por ejemplo, la función AuthenticatedChannelKeyExchange ) si el dispositivo para mostrar especificado en esas llamadas es diferente del dispositivo para mostrar que se usó para crear el canal autenticado.

Requisitos

Requisito Value
Cliente mínimo compatible CreateAuthenticatedChannel se admite a partir del sistema operativo Windows 7.
Plataforma de destino Escritorio
Encabezado d3dumddi.h (incluya D3dumddi.h)

Consulte también

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL