PFND3DDDI_STARTSESSIONKEYREFRESH funzione di callback (d3dumddi.h)
La funzione StartSessionKeyRefresh restituisce un numero casuale che la funzione FinishSessionKeyRefresh del driver usa successivamente per eseguire un'operazione OR esclusiva (XOR) con la chiave di sessione.
Sintassi
PFND3DDDI_STARTSESSIONKEYREFRESH Pfnd3dddiStartsessionkeyrefresh;
HRESULT Pfnd3dddiStartsessionkeyrefresh(
HANDLE hDevice,
const D3DDDIARG_STARTSESSIONKEYREFRESH *unnamedParam2
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pData [in, out]
Puntatore a una struttura D3DDDIARG_STARTSESSIONKEYREFRESH contenente informazioni sul numero casuale.
Valore restituito
StartSessionKeyRefresh restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| S_OK | Il numero casuale viene restituito correttamente. |
| D3DDDIERR_NOTAVAILABLE | Il driver non supporta la funzione StartSessionKeyRefresh. |
Commenti
L'hardware e il driver possono facoltativamente supportare StartSessionKeyRefresh per tutti i tipi di crittografia.
Quando il runtime Direct3D chiama la funzione StartSessionKeyRefresh del driver, il driver genera e salva un numero casuale e restituisce il numero casuale nel buffer a cui punta il membro pRandomNumber della struttura D3DDDIARG_STARTSESSIONKEYREFRESH .
Quando il runtime chiama successivamente la funzione FinishSessionKeyRefresh del driver, il driver esegue un'operazione XOR del numero casuale con la chiave di sessione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | StartSessionKeyRefresh è supportato a partire dal sistema operativo Windows 7. |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dumddi.h (include D3dumddi.h) |