PFND3DWDDM2_4DDI_NEGOTIATECRYPTOSESSIONKEYEXCHANGE fonction de rappel (d3d10umddi.h)
É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) |