PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE función de devolución de llamada (d3dumddi.h)
La función AuthenticatedChannelKeyExchange negocia la clave de sesión.
Sintaxis
PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3dddiAuthenticatedchannelkeyexchange;
HRESULT Pfnd3dddiAuthenticatedchannelkeyexchange(
HANDLE hDevice,
D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE *unnamedParam2
)
{...}
Parámetros
hDevice
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
pData [in, out]
Puntero a una estructura de D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE que describe un búfer que contiene la clave de sesión, que usa el canal autenticado.
Valor devuelto
AuthenticatedChannelKeyExchange devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| S_OK | La clave de sesión se negocia correctamente. |
| E_OUTOFMEMORY | AuthenticatedChannelKeyExchange no pudo asignar la memoria necesaria para que se complete. |
Comentarios
El miembro pData de la estructura D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE apunta a un búfer que contiene una clave secreta que una aplicación cifrada anteriormente RSAES-OAEP-con la clave pública del certificado de canal autenticado del controlador. El tamaño real del búfer es de 256 bytes. Este intercambio es idéntico al funcionamiento del intercambio de claves del Administrador de protección de resultados (OPM), excepto que el búfer de OPM contiene datos adicionales además de la clave de sesión. El mismo certificado que se usa para el intercambio de claves de OPM se puede usar para el canal autenticado.
El controlador descifra esta clave secreta y usa la clave secreta en llamadas a las funciones ConfigureAuthenticatedChannel y QueryAuthenticatedChannel del controlador para calcular los códigos de autenticación de mensajes (OMAC) de cifrado de bloque cifrado de clave única (CBC).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | AuthenticatedChannelKeyExchange se admite a partir del sistema operativo Windows 7. |
| Plataforma de destino | Escritorio |
| Encabezado | d3dumddi.h (incluya D3dumddi.h) |