PFND3DDDI_STARTSESSIONKEYREFRESH fonction de rappel (d3dumddi.h)
La fonction StartSessionKeyRefresh retourne un nombre aléatoire que la fonction FinishSessionKeyRefresh du pilote utilise par la suite pour effectuer une opération OR exclusive (XOR) avec la clé de session.
Syntaxe
PFND3DDDI_STARTSESSIONKEYREFRESH Pfnd3dddiStartsessionkeyrefresh;
HRESULT Pfnd3dddiStartsessionkeyrefresh(
HANDLE hDevice,
const D3DDDIARG_STARTSESSIONKEYREFRESH *unnamedParam2
)
{...}
Paramètres
hDevice
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in, out]
Pointeur vers une structure D3DDDIARG_STARTSESSIONKEYREFRESH qui contient des informations sur le nombre aléatoire.
Valeur de retour
StartSessionKeyRefresh retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| S_OK | Le nombre aléatoire est retourné avec succès. |
| D3DDDIERR_NOTAVAILABLE | Le pilote ne prend pas en charge la fonction StartSessionKeyRefresh. |
Remarques
Le matériel et le pilote peuvent éventuellement prendre en charge StartSessionKeyRefresh pour tous les types de chiffrement.
Lorsque le runtime Direct3D appelle la fonction StartSessionKeyRefresh du pilote, le pilote génère et enregistre un nombre aléatoire et retourne le nombre aléatoire dans la mémoire tampon vers laquelle le pRandomNumber membre de la structure D3DDDIARG_STARTSESSIONKEYREFRESH pointe.
Lorsque le runtime appelle ensuite la fonction FinishSessionKeyRefresh du pilote, le pilote effectue une opération XOR du nombre aléatoire avec la clé de session.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | StartSessionKeyRefresh est pris en charge à partir du système d’exploitation Windows 7. |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |