PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE Rückruffunktion (d3dumddi.h)
Die AuthenticatedChannelKeyExchange-Funktion handelt den Sitzungsschlüssel aus.
Syntax
PFND3DDDI_AUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3dddiAuthenticatedchannelkeyexchange;
HRESULT Pfnd3dddiAuthenticatedchannelkeyexchange(
HANDLE hDevice,
D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData [in, out]
Ein Zeiger auf eine D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE Struktur, die einen Puffer beschreibt, der den Sitzungsschlüssel enthält, den der authentifizierte Kanal verwendet.
Rückgabewert
AuthenticatedChannelKeyExchange gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der Sitzungsschlüssel wird erfolgreich ausgehandelt. |
| E_OUTOFMEMORY | AuthenticatedChannelKeyExchange konnte den erforderlichen Arbeitsspeicher nicht zuordnen, damit er abgeschlossen werden kann. |
Bemerkungen
Der pData--Member in der D3DDDIARG_AUTHENTICATEDCHANNELKEYEXCHANGE-Struktur verweist auf einen Puffer, der einen geheimen Schlüssel enthält, den eine Anwendung zuvor RSAES-OAEP mit dem öffentlichen Schlüssel aus dem authentifizierten Kanalzertifikat des Treibers verschlüsselt hat. Die tatsächliche Größe des Puffers beträgt 256 Byte. Dieser Austausch ist identisch mit der Funktionsweise des Output Protection Manager (OPM)-Schlüsselaustausch, außer der OPM-Puffer enthält neben dem Sitzungsschlüssel zusätzliche Daten. Dasselbe Zertifikat, das für den OPM-Schlüsselaustausch verwendet wird, kann für den authentifizierten Kanal verwendet werden.
Der Treiber entschlüsselt diesen geheimen Schlüssel und verwendet den geheimen Schlüssel in Aufrufen der ConfigureAuthenticatedChannel des Treibers und QueryAuthenticatedChannel Funktionen zum Berechnen von Nachrichtenauthentifizierungscodes im One-Key-Chiffreblockverkettungsmodus (CBC)-Modus.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | AuthenticatedChannelKeyExchange wird beginnend mit dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |