Condividi tramite


PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE funzione di callback (d3dumddi.h)

La funzione AuthenticationdChannelKeyExchange negozia la chiave di sessione.

Sintassi

PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3dddiAuthenticatedchannelkeyexchange;

HRESULT Pfnd3dddiAuthenticatedchannelkeyexchange(
  HANDLE hDevice,
  D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE *unnamedParam2
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE che descrive un buffer contenente la chiave di sessione, utilizzata dal canale autenticato.

Valore restituito

AuthenticationdChannelKeyExchange restituisce uno dei valori seguenti:

Codice restituito Descrizione
S_OK La chiave di sessione viene negoziata correttamente.
E_OUTOFMEMORY AuthenticationdChannelKeyExchange non è riuscito a allocare la memoria necessaria per il completamento.

Commenti

Il membro pData nella struttura D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE punta a un buffer che contiene una chiave privata che un'applicazione in precedenza RSAES-OAEP crittografata con la chiave pubblica dal certificato del canale autenticato dal driver. Le dimensioni effettive del buffer sono 256 byte. Questo scambio è identico al funzionamento dello scambio di chiavi OPM ( Output Protection Manager ), ad eccezione del buffer OPM che contiene dati aggiuntivi oltre alla chiave di sessione. Lo stesso certificato usato per lo scambio di chiavi OPM può essere usato per il canale autenticato.

Il driver decrittografa questa chiave privata e usa la chiave privata nelle chiamate a ConfigureAuthenticatedChannel e QueryAuthenticatedChannel per calcolare i codici di autenticazione dei messaggi in modalità CBC (One-Key Cipher Block Chaining).

Requisiti

Requisito Valore
Client minimo supportato AuthenticationdChannelKeyExchange è supportato a partire dal sistema operativo Windows 7.
Piattaforma di destinazione Desktop
Intestazione d3dumddi.h (include D3dumddi.h)

Vedi anche

D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE