PFND3DDDI_CREATEAUTHENTICATEDCHANNEL función de devolución de llamada (d3dumddi.h)
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) |