PFND3DWDDM2_4DDI_NEGOTIATECRYPTOSESSIONKEYEXCHANGE fonction de rappel (d3d10umddi.h)

  • Article

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

Syntaxe

PFND3DWDDM2_4DDI_NEGOTIATECRYPTOSESSIONKEYEXCHANGE Pfnd3dwddm24DdiNegotiatecryptosessionkeyexchange;

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

Paramètres

hDevice

Handle pour le périphérique d’affichage (contexte graphique).

hCryptoSession

Handle pour les données privées du pilote pour la session de chiffrement. Ce handle a été créé par le runtime Direct3D et passé au pilote dans l’appel à CreateCryptoSession.

flags

Valeur de l’indicateur pour la fonction.

DataSize

Taille, en octets, des données vers laquelle pointe le membre pData.

pData

Pointeur vers une mémoire tampon qui contient la clé de session chiffrée.

Valeur retournée

Retourne l’une des valeurs HRESULT 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.

Notes

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

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d10umddi.h (include S3d10umddi.h)