PFND3DDDI_GETENCRYPTIONBLTKEY Rückruffunktion (d3dumddi.h)
Die GetEncryptionBltKey-Funktion gibt den Schlüssel zurück, der zum Entschlüsseln der Daten verwendet wird, die der EncryptionBlt--Funktion des Treibers zurückgibt.
Syntax
PFND3DDDI_GETENCRYPTIONBLTKEY Pfnd3dddiGetencryptionbltkey;
HRESULT Pfnd3dddiGetencryptionbltkey(
HANDLE hDevice,
const D3DDDIARG_GETENCRYPTIONBLTKEY *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData- [in, out]
Ein Zeiger auf eine D3DDDIARG_GETENCRYPTIONBLTKEY Struktur, die den Schlüssel für eine verschlüsselte Sitzung beschreibt.
Rückgabewert
GetEncryptionBltKey gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der Schlüssel für eine verschlüsselte Sitzung wird erfolgreich abgerufen. |
| D3DDDIERR_NOTAVAILABLE | Der Treiber unterstützt die GetEncryptionBltKey-Funktion nicht. |
Bemerkungen
Die Hardware und der Treiber können optional die GetEncryptionBltKey Funktion für alle Kryptotypen unterstützen.
Jedes Mal, wenn die Direct3D-Laufzeit die GetEncryptionBltKey--Funktion des Treibers aufruft, sollte der Treiber eine neue Rücklesetaste generieren. Wenn die CreateCryptoSession-Funktion des Treibers zuvor die Verschlüsselungssitzung mit dem CryptoType Mitglied der D3DDDIARG_CREATECRYPTOSESSION-Struktur erstellt hat, die auf D3DCRYPTOTYPE_AES128_CTR festgelegt ist, sollte der Treiber und die Hardware den Rückleseschlüssel mit dem Sitzungsschlüssel verschlüsseln.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | GetEncryptionBltKey wird ab dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |