PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE Rückruffunktion (d3d10umddi.h)
Erstellt einen Sitzungsschlüssel für einen authentifizierten Kanal.
Syntax
PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange;
HRESULT Pfnd3d111DdiNegotiateauthenticatedchannelkeyexchange(
D3D10DDI_HDEVICE hDevice,
D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
UINT DataSize,
VOID *pData
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
hCAuthChannel
Ein Handle für ein authentifiziertes Kanalobjekt, das durch einen Aufruf der CreateAuthenticatedChannel(D3D11_1) -Funktion erstellt wurde.
DataSize
Die Größe der Daten im pData-Array in Byte.
pData
Ein Zeiger auf ein Bytearray, das den verschlüsselten Sitzungsschlüssel enthält.
Rückgabewert
NegotiateAuthenticatedChannelKeyExchange gibt einen der folgenden Werte zurück:
Rückgabecode | Beschreibung |
---|---|
S_OK | Der Sitzungsschlüssel für den authentifizierten Kanal wurde erfolgreich ausgehandelt. |
E_INVALIDARG | Die Parameter wurden überprüft und als falsch ermittelt. |
E_OUTOFMEMORY | Der Arbeitsspeicher war zum Abschließen des Vorgangs nicht verfügbar. |
Hinweise
Der pData-Parameter verweist auf einen Puffer, der einen Sitzungsschlüssel für den authentifizierten Kanal enthält. Dieser Schlüsselpuffer muss 256 Bytes Daten enthalten und mit dem RSAES-OAEP-Algorithmus (RSAES-OAEP) mit dem öffentlichen Schlüssel aus dem authentifizierten Kanalzertifikat verschlüsselt werden.
Der Schlüsselaustausch für einen authentifizierten Kanal ist identisch mit dem Schlüsselaustausch für die OpM-Schnittstelle (Output Protection Manager). Der OPM-Schlüsselpuffer enthält jedoch neben dem Sitzungsschlüssel zusätzliche Daten.
Hinweis
Dasselbe Zertifikat kann für den authentifizierten Kanal und den OPM-Sitzungsschlüssel verwendet werden.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 8 |
Unterstützte Mindestversion (Server) | Windows Server 2012 |
Zielplattform | Desktop |
Kopfzeile | d3d10umddi.h (include D3d10umddi.h) |