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 de retorno | descripción |
|---|---|
| S_OK | El canal autenticado está configurado correctamente. |
| E_OUTOFMEMORY | ConfigureAuthenticatedChannel no pudo asignar la memoria necesaria para que se complete. |
Observaciones
El búfer de entrada contiene un código de autenticación de mensajes en modo CBC (CBC) de cifrado 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 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 cómo controla actualmente 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 operaciones diferentes en función de cada uno de los GUID siguientes que se especifican 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 | Valor |
|---|---|
| cliente mínimo admitido | ConfigureAuthenticatedChannel se admite a partir del sistema operativo Windows 7. |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |