PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE fonction de rappel (d3d10umddi.h)

Article
02/06/2025

Établit une clé de session pour un canal authentifié.

Syntaxe

PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange;

HRESULT Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
  UINT DataSize,
  VOID *pData
)
{...}

Paramètres

hDevice

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

hCAuthChannel

Handle vers un objet de canal authentifié créé via un appel à la fonction CreateAuthenticatedChannel(D3D11_1).

DataSize

Taille, en octets, des données du tableau pData.

pData

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

Valeur de retour

NegotiateAuthenticatedChannelKeyExchange retourne l’une des valeurs suivantes :

Retourner le code	Description
S_OK	La clé de session du canal authentifié 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 le canal authentifié. Cette mémoire tampon de clé doit contenir 256 octets de données et doit être chiffrée à l’aide du schéma de chiffrement RSA - Algorithme de remplissage de chiffrement asymétrique optimal (RSAES-OAEP) avec la clé publique à partir du certificat de canal authentifié.

L’échange de clés pour un canal authentifié 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 le canal authentifié et la clé de session OPM.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Bureau
d’en-tête	d3d10umddi.h (include D3d10umddi.h)

Voir aussi

CreateAuthenticatedChannel(D3D11_1)

Partager via