PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE funzione di callback (d3d10umddi.h)

Articolo
02/06/2025

Stabilisce una chiave di sessione per un oggetto sessione di crittografia.

Sintassi

PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE Pfnd3d111DdiNegotiatecryptosessionkeyeschange;

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

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

hCryptoSession

Handle per l'oggetto sessione di crittografia creato tramite una chiamata alla funzione CreateCryptoSession.

DataSize

Dimensione, in byte, dei dati nella matrice pData.

pData

Puntatore a una matrice di byte che contiene la chiave di sessione crittografata.

Valore restituito

NegotiateCryptoSessionKeyExchange restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	La chiave di sessione per la sessione di crittografia è stata negoziata correttamente.
E_INVALIDARG	I parametri sono stati convalidati e sono stati determinati in modo che non siano corretti.
E_OUTOFMEMORY	Memoria non disponibile per completare l'operazione.

Osservazioni

Il parametro pData fa riferimento a un buffer contenente una chiave di sessione per la sessione di crittografia. Il meccanismo di scambio delle chiavi dipende dal tipo dell'algoritmo di crittografia usato dalla sessione di crittografia.

Per le sessioni che usano lo schema di crittografia RSA - Padding di crittografia asimmetrica ottimale (RSAES-OAEP), il buffer delle chiavi deve contenere 256 byte di dati e deve essere crittografato usando lo schema di crittografia RSA - Padding di crittografia asimmetrica ottimale (RSAES-OAEP) algoritmo con la chiave pubblica del certificato della sessione di crittografia.

Lo scambio di chiavi per una sessione di crittografia è identico allo scambio di chiavi per l'interfaccia OPM (Output Protection Manager). Tuttavia, il buffer della chiave OPM contiene dati aggiuntivi oltre alla chiave di sessione.

Nota Lo stesso certificato può essere usato per la sessione di crittografia e la chiave di sessione OPM.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Desktop
intestazione	d3d10umddi.h (include D3d10umddi.h)

Vedere anche

CreateCryptoSession

Condividi tramite