PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE fonction de rappel (d3d10umddi.h)

Article
02/22/2024

Établit une clé de session pour un objet de session de chiffrement.

Syntaxe

PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE Pfnd3d111DdiNegotiatecryptosessionkeyeschange;

HRESULT Pfnd3d111DdiNegotiatecryptosessionkeyeschange(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HCRYPTOSESSION hCryptoSession,
  UINT DataSize,
  BYTE *pData
)
{...}

Paramètres

hDevice

Handle de l’appareil d’affichage (contexte graphique).

hCryptoSession

Handle de l’objet de session de chiffrement qui a été créé via un appel à la fonction CreateCryptoSession .

DataSize

Taille, en octets, des données dans le tableau pData .

pData

Pointeur vers un tableau d’octets qui contient la clé de session chiffrée.

Valeur retournée

NegotiateCryptoSessionKeyExchange retourne l’une des valeurs suivantes :

Code de retour	Description
S_OK	La clé de session de la session de chiffrement a été négociée avec succès.
E_INVALIDARG	Les paramètres ont été validés et déterminés comme incorrects.
E_OUTOFMEMORY	La mémoire n’était pas disponible pour terminer l’opération.

Remarques

Le paramètre pData fait référence à une mémoire tampon qui contient une clé de session pour la session de chiffrement. Le mécanisme d’échange de clés dépend du type de l’algorithme de chiffrement utilisé par la session de chiffrement.

Pour les sessions qui utilisent l’algorithme RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP), la mémoire tampon de clé doit contenir 256 octets de données et doit être chiffrée à l’aide de l’algorithme RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP) avec la clé publique du certificat de session de chiffrement.

L’échange de clés pour une session de chiffrement est identique à l’échange de clés pour l’interface OPM (Output Protection Manager). Toutefois, la mémoire tampon de clé OPM contient des données supplémentaires en plus de la clé de session.

Note Le même certificat peut être utilisé pour la session de chiffrement et la clé de session OPM.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3d10umddi.h (include D3d10umddi.h)

Voir aussi

CreateCryptoSession

Partager via