PFND3DDDI_STARTSESSIONKEYREFRESH Rückruffunktion (d3dumddi.h)
Die StartSessionKeyRefresh--Funktion gibt eine Zufallszahl zurück, die die FinishSessionKeyRefresh- Funktion des Treibers anschließend zum Ausführen eines exklusiven OR-Vorgangs (XOR) mit dem Sitzungsschlüssel verwendet.
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 zur 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 StartSessionKeyRefresh-Funktion nicht. |
Bemerkungen
Die Hardware und der Treiber können optional StartSessionKeyRefresh- für alle Kryptotypen unterstützen.
Wenn die Direct3D-Laufzeit die StartSessionKeyRefresh- funktion des Treibers aufruft, generiert und speichert der Treiber eine Zufallszahl und gibt die Zufallszahl im Puffer zurück, auf die der pRandomNumber Member der D3DDDIARG_STARTSESSIONKEYREFRESH Struktur verweist.
Wenn die Laufzeit anschließend die FinishSessionKeyRefresh--Funktion des Treibers aufruft, führt der Treiber einen XOR-Vorgang der Zufallszahl mit dem Sitzungsschlüssel aus.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | StartSessionKeyRefresh wird beginnend mit dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |