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) |