PFND3DDDI_STARTSESSIONKEYREFRESH Rückruffunktion (d3dumddi.h)
Die Funktion StartSessionKeyRefresh gibt eine Zufallszahl zurück, die die Funktion FinishSessionKeyRefresh des Treibers anschließend verwendet, um einen exklusiven OR-Vorgang (XOR) mit dem Sitzungsschlüssel auszuführen.
Syntax
PFND3DDDI_STARTSESSIONKEYREFRESH Pfnd3dddiStartsessionkeyrefresh;
HRESULT Pfnd3dddiStartsessionkeyrefresh(
HANDLE hDevice,
const D3DDDIARG_STARTSESSIONKEYREFRESH *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData [in, out]
Ein Zeiger auf eine D3DDDIARG_STARTSESSIONKEYREFRESH Struktur, die Informationen über die Zufallszahl enthält.
Rückgabewert
StartSessionKeyRefresh gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Zufallszahl wird erfolgreich zurückgegeben. |
| D3DDDIERR_NOTAVAILABLE | Der Treiber unterstützt die Funktion StartSessionKeyRefresh nicht. |
Hinweise
Die Hardware und der Treiber können optional StartSessionKeyRefresh für alle Kryptotypen unterstützen.
Wenn die Direct3D-Runtime die StartSessionKeyRefresh-Funktion des Treibers aufruft, generiert und speichert der Treiber eine Zufallszahl und gibt die Zufallszahl im Puffer zurück, auf die das pRandomNumber-Element der D3DDDIARG_STARTSESSIONKEYREFRESH-Struktur zeigt.
Wenn die Laufzeit anschließend die Funktion FinishSessionKeyRefresh des Treibers aufruft, führt der Treiber einen XOR-Vorgang der Zufallszahl mit dem Sitzungsschlüssel aus.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | StartSessionKeyRefresh wird ab dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |