PFND3DWDDM2_4DDI_NEGOTIATECRYPTOSESSIONKEYEXCHANGE Rückruffunktion (d3d10umddi.h)
Erstellt einen Sitzungsschlüssel für ein kryptografisches Sitzungsobjekt.
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-Runtime erstellt und im Aufruf von CreateCryptoSession an den Treiber übergeben.
flags
Der Flagwert für die Funktion.
DataSize
Die Größe der Daten, auf die das pData-Element verweist, in Bytes.
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 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 |
---|---|
Zielplattform | Windows |
Kopfzeile | d3d10umddi.h (einschließlich S3d10umddi.h) |