PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE funzione di callback (d3d10umddi.h)

Stabilisce una chiave di sessione per un canale autenticato.

Sintassi

PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange;

HRESULT Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
  UINT DataSize,
  VOID *pData
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

hCAuthChannel

Handle per un oggetto canale autenticato creato tramite una chiamata alla funzione CreateAuthenticatedChannel(D3D11_1).

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

NegotiateAuthenticatedChannelKeyExchange restituisce uno dei valori seguenti:

Codice restituito Descrizione
S_OK La chiave di sessione per il canale autenticato è 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 il canale autenticato. Questo buffer di chiavi deve contenere 256 byte di dati e deve essere crittografato usando l'algoritmo RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP) con la chiave pubblica dal certificato del canale autenticato.

Lo scambio di chiavi per un canale autenticato è 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 il canale autenticato 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

CreateAuthenticatedChannel(D3D11_1)