PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE fonction de rappel (d3d10umddi.h)

Article
02/22/2024

É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 pour le périphérique d’affichage (contexte graphique).

hCAuthChannel

Handle pour un objet de canal authentifié qui a été créé via un appel à la fonction CreateAuthenticatedChannel(D3D11_1).

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

NegotiateAuthenticatedChannelKeyExchange retourne l’une des valeurs suivantes :

Code de retour	Description
S_OK	La clé de session pour le 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 de l’algorithme RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP) avec la clé publique 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.

Notes

Le même certificat peut être utilisé pour le canal authentifié 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 (incluez D3d10umddi.h)

Voir aussi

CreateAuthenticatedChannel(D3D11_1)

Partager via