Partager via


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 de D3DDDIARG_STARTSESSIONKEYREFRESH qui contient des informations sur le nombre aléatoire.

Valeur retournée

StartSessionKeyRefresh retourne l’une des valeurs suivantes :

Code de retour 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, celui-ci génère et enregistre un nombre aléatoire et retourne le nombre aléatoire dans la mémoire tampon vers laquelle pointe le membre pRandomNumber de la structure D3DDDIARG_STARTSESSIONKEYREFRESH .

Lorsque le runtime appelle ensuite la fonction FinishSessionKeyRefresh du pilote, celui-ci effectue une opération XOR du nombre aléatoire avec la clé de session.

Configuration requise

Condition requise Valeur
Client minimal pris en charge StartSessionKeyRefresh est pris en charge à partir du système d’exploitation Windows 7.
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dumddi.h (inclure D3dumddi.h)

Voir aussi

D3DDDIARG_STARTSESSIONKEYREFRESH

FinishSessionKeyRefresh