PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE funzione di callback (d3d10umddi.h)

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 come non corretti.
E_OUTOFMEMORY Memoria non disponibile per completare l'operazione.

Commenti

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

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

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.
 

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Desktop
Intestazione d3d10umddi.h (include D3d10umddi.h)

Vedi anche

CreateCryptoSession