PFND3D11_1DDI_NEGOTIATEAUTHENTICATEDCHANNELKEYEXCHANGE Rückruffunktion (d3d10umddi.h)
Richtet einen Sitzungsschlüssel für einen authentifizierten Kanal ein.
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 zu einem authentifizierten Kanalobjekt, das über 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 | 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 den authentifizierten Kanal enthält. Dieser Schlüsselpuffer muss 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 authentifizierten Kanalzertifikat.
Der Schlüsselaustausch für einen authentifizierten Kanal 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 den authentifizierten Kanal und den OPM-Sitzungsschlüssel verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |