PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE función de devolución de llamada (d3d10umddi.h)
Establece una clave de sesión para un canal autenticado.
Sintaxis
PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange;
HRESULT Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange(
D3D10DDI_HDEVICE hDevice,
D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
UINT DataSize,
VOID *pData
)
{...}
Parámetros
hDevice
Identificador del dispositivo de visualización (contexto de gráficos).
hCAuthChannel
Identificador de un objeto de canal autenticado que se creó a través de una llamada a la función CreateAuthenticatedChannel(D3D11_1).
DataSize
Tamaño, en bytes, de los datos de la matriz de pData.
pData
Puntero a una matriz de bytes que contiene la clave de sesión cifrada.
Valor devuelto
NegotiateAuthenticatedChannelKeyExchange devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| S_OK | La clave de sesión del canal autenticado se negoció correctamente. |
| E_INVALIDARG | Los parámetros se validaron y determinaron que son incorrectos. |
| E_OUTOFMEMORY | La memoria no estaba disponible para completar la operación. |
Observaciones
El parámetro pData hace referencia a un búfer que contiene una clave de sesión para el canal autenticado. Este búfer de claves debe contener 256 bytes de datos y debe cifrarse mediante el esquema de cifrado RSA: relleno óptimo de cifrado asimétrico (RSAES-OAEP) con la clave pública del certificado de canal autenticado.
El intercambio de claves para un canal autenticado es idéntico al intercambio de claves para la interfaz del Administrador de protección de salida (OPM). Sin embargo, el búfer de claves de OPM contiene datos adicionales además de la clave de sesión.
Nota
El mismo certificado se puede usar para el canal autenticado y la clave de sesión de OPM.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 |
| servidor mínimo admitido | Windows Server 2012 |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3d10umddi.h (incluya D3d10umddi.h) |