PFND3DDDI_STARTSESSIONKEYREFRESH funzione di callback (d3dumddi.h)
La funzione StartSessionKeyRefresh restituisce un numero casuale usato dalla funzione FinishSessionKeyRefresh del driver successivamente per eseguire un'operazione OR (XOR) esclusiva 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 che contiene 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. |
Osservazioni
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 pRandomNumber membro della struttura D3DDDIARG_STARTSESSIONKEYREFRESH.
Quando il runtime chiama successivamente il funzione FinishSessionKeyRefresh del driver, il driver esegue un'operazione XOR del numero casuale con la chiave di sessione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | StartSessionKeyRefresh è supportato a partire dal sistema operativo Windows 7. |
| piattaforma di destinazione | Desktop |
| intestazione | d3dumddi.h (include D3dumddi.h) |