PFND3DDDI_STARTSESSIONKEYREFRESH función de devolución de llamada (d3dumddi.h)
La función StartSessionKeyRefresh devuelve un número aleatorio que la función FinishSessionKeyRefresh del controlador usa posteriormente para realizar una operación OR exclusiva (XOR) con la clave de sesión.
Sintaxis
PFND3DDDI_STARTSESSIONKEYREFRESH Pfnd3dddiStartsessionkeyrefresh;
HRESULT Pfnd3dddiStartsessionkeyrefresh(
HANDLE hDevice,
const D3DDDIARG_STARTSESSIONKEYREFRESH *unnamedParam2
)
{...}
Parámetros
hDevice
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
pData [in, out]
Puntero a una estructura D3DDDIARG_STARTSESSIONKEYREFRESH que contiene información sobre el número aleatorio.
Valor devuelto
StartSessionKeyRefresh devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| S_OK | El número aleatorio se devuelve correctamente. |
| D3DDDIERR_NOTAVAILABLE | El controlador no admite la función StartSessionKeyRefresh. |
Comentarios
El hardware y el controlador pueden admitir opcionalmente StartSessionKeyRefresh para todos los tipos criptográficos.
Cuando el tiempo de ejecución de Direct3D llama a la función StartSessionKeyRefresh del controlador, el controlador genera y guarda un número aleatorio y devuelve el número aleatorio en el búfer al que apunta el miembro pRandomNumber de la estructura D3DDDIARG_STARTSESSIONKEYREFRESH .
Cuando el tiempo de ejecución llama posteriormente a la función FinishSessionKeyRefresh del controlador, el controlador realiza una operación XOR del número aleatorio con la clave de sesión.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | StartSessionKeyRefresh se admite a partir del sistema operativo Windows 7. |
| Plataforma de destino | Escritorio |
| Encabezado | d3dumddi.h (incluya D3dumddi.h) |