PFND3DDDI_GETENCRYPTIONBLTKEY Rückruffunktion (d3dumddi.h)
Die GetEncryptionBltKey-Funktion gibt den Schlüssel zurück, der zum Entschlüsseln der Daten verwendet wird, die von der EncryptionBlt-Funktion des Treibers zurückgegeben werden.
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 wurde erfolgreich abgerufen. |
| D3DDDIERR_NOTAVAILABLE | Der Treiber unterstützt die GetEncryptionBltKey-Funktion nicht. |
Hinweise
Die Hardware und der Treiber können optional die GetEncryptionBltKey-Funktion für alle Kryptotypen unterstützen.
Jedes Mal, wenn die Direct3D-Runtime die GetEncryptionBltKey-Funktion des Treibers aufruft, sollte der Treiber einen neuen Rückleseschlüssel generieren. Wenn die CreateCryptoSession-Funktion des Treibers zuvor die Verschlüsselungssitzung mit dem CryptoType-Member der D3DDDIARG_CREATECRYPTOSESSION-Struktur erstellt hat, die auf D3DCRYPTOTYPE_AES128_CTR festgelegt ist, sollten Treiber und Hardware den Zurückleseschlüssel mit dem Sitzungsschlüssel verschlüsseln.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | GetEncryptionBltKey wird ab dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |