PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE Rückruffunktion (d3d10umddi.h)

  • Artikel

Erstellt einen Sitzungsschlüssel für ein kryptografisches Sitzungsobjekt.

Syntax

PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE Pfnd3d111DdiNegotiatecryptosessionkeyeschange;

HRESULT Pfnd3d111DdiNegotiatecryptosessionkeyeschange(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HCRYPTOSESSION hCryptoSession,
  UINT DataSize,
  BYTE *pData
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

hCryptoSession

Ein Handle für das kryptografische Sitzungsobjekt, das durch einen Aufruf der CreateCryptoSession-Funktion erstellt wurde.

DataSize

Die Größe der Daten im pData-Array in Bytes.

pData

Ein Zeiger auf ein Bytearray, das den verschlüsselten Sitzungsschlüssel enthält.

Rückgabewert

NegotiateCryptoSessionKeyExchange gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der Sitzungsschlüssel für die kryptografische Sitzung wurde erfolgreich ausgehandelt.
E_INVALIDARG Parameter wurden überprüft und als falsch ermittelt.
E_OUTOFMEMORY Arbeitsspeicher war nicht verfügbar, um den Vorgang abzuschließen.

Hinweise

Der pData-Parameter verweist auf einen Puffer, der einen Sitzungsschlüssel für die kryptografische Sitzung enthält. Der Schlüsselaustauschmechanismus hängt vom Typ des Verschlüsselungsalgorithmus ab, der von der kryptografischen Sitzung verwendet wird.

Für Sitzungen, die den RSAES-OAEP-Algorithmus (RSAES-OAEP) verwenden, muss der Schlüsselpuffer 256 Byte Daten enthalten und mit dem RSAES-OAEP-Algorithmus (RSA Encryption Scheme – Optimal Asymmetric Encryption Padding) mit dem öffentlichen Schlüssel aus dem kryptografischen Sitzungszertifikat verschlüsselt werden.

Der Schlüsselaustausch für eine kryptografische Sitzung 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 die kryptografische Sitzung 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 (einschließlich D3d10umddi.h)

Weitere Informationen

CreateCryptoSession