PFND3DWDDM2_4DDI_NEGOTIATECRYPTOSESSIONKEYEXCHANGE Rückruffunktion (d3d10umddi.h)

Artikel
02/06/2025

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

Syntax

PFND3DWDDM2_4DDI_NEGOTIATECRYPTOSESSIONKEYEXCHANGE Pfnd3dwddm24DdiNegotiatecryptosessionkeyexchange;

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

Parameter

hDevice

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

hCryptoSession

Ein Handle für die privaten Daten des Treibers für die kryptografische Sitzung. Dieses Handle wurde von der Direct3D-Laufzeit erstellt und an den Treiber im Aufruf von CreateCryptoSession übergeben.

flags

Der Flagwert für die Funktion.

DataSize

Die Größe der Daten, auf die das pData-Element in Bytes verweist.

pData

Ein Zeiger auf einen Puffer, der den verschlüsselten Sitzungsschlüssel enthält.

Rückgabewert

Gibt einen der folgenden HRESULT-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 ermittelt, dass sie falsch sind.
E_OUTOFMEMORY	Der Arbeitsspeicher war nicht verfügbar, um den Vorgang abzuschließen.

Bemerkungen

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 das RSA-Verschlüsselungsschema verwenden : Optimal asymmetrischer Verschlüsselungsabstand (RSAES-OAEP) Algorithmus, muss der Schlüsselpuffer 256 Byte Daten enthalten und muss mithilfe des RSA-Verschlüsselungsschemas verschlüsselt werden - Optimal asymmetrischer Verschlüsselungsabstand (RSAES-OAEP) Algorithmus mit dem öffentlichen Schlüssel aus dem kryptografischen Sitzungszertifikat.

Der Schlüsselaustausch für eine kryptografische Sitzung ist identisch mit dem Schlüsselaustausch für die Output Protection Manager (OPM)-Schnittstelle. Der OPM-Schlüsselpuffer enthält jedoch neben dem Sitzungsschlüssel zusätzliche Daten.

Anmerkung

Dasselbe Zertifikat kann für die kryptografische Sitzung und den OPM-Sitzungsschlüssel verwendet werden.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	d3d10umddi.h (einschließlich S3d10umddi.h)

Freigeben über