PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL función de devolución de llamada (d3dumddi.h)
La función ConfigureAuthenticatedChannel establece el estado dentro de un canal autenticado.
Sintaxis
PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;
HRESULT Pfnd3dddiConfigureauthenicatedchannel(
HANDLE hDevice,
const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
Parámetros
hDevice
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
pData [in, out]
Puntero a una estructura de D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL que describe cómo configurar un canal autenticado. Esta estructura contiene un búfer de entrada que describe cómo configurar el canal autenticado y un búfer de salida con información de configuración.
Valor devuelto
ConfigureAuthenticatedChannel devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| S_OK | El canal autenticado se ha configurado correctamente. |
| E_OUTOFMEMORY | ConfigureAuthenticatedChannel no pudo asignar la memoria necesaria para que se complete. |
Comentarios
El búfer de entrada contiene un código de autenticación de mensajes en modo CBC (CBC) de clave única que el controlador debe autenticar. El búfer de entrada también contiene el identificador del controlador para el canal autenticado, un número de secuencia y un GUID que indica el tipo de configuración.
El controlador debe producir un error en ConfigureAuthenticatedChannel si la entrada OMAC no coincide, si el número de secuencia no es mayor que un número de secuencia especificado en una llamada anterior o si el número de secuencia aún no se ha inicializado (la excepción a esta última regla es para la propia llamada de inicialización).
El controlador debe duplicar los datos de entrada en la estructura del búfer de salida y debe firmar la estructura de salida de forma idéntica a la forma en que actualmente controla las consultas del Administrador de protección de salida (OPM).
Excepto en aquellas situaciones en las que la aplicación especifica incorrectamente un búfer de salida demasiado pequeño, el controlador siempre debe colocar el código de retorno en la estructura de salida. Por lo tanto, la aplicación tiene un mecanismo seguro para determinar el código de retorno.
ConfigureAuthenticatedChannel realiza diferentes operaciones en función de cada uno de los SIGUIENTES GUID especificados en la estructura de entrada. El controlador debe producir un error si el tamaño del búfer de entrada no coincide con el tamaño definido para el GUID especificado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | ConfigureAuthenticatedChannel se admite a partir del sistema operativo Windows 7. |
| Plataforma de destino | Escritorio |
| Encabezado | d3dumddi.h (incluya D3dumddi.h) |