PFND3DDDI_CREATECRYPTOSESSION Rückruffunktion (d3dumddi.h)

  • Artikel

Die CreateCryptoSession-Funktion erstellt eine Kryptositzung, die die Direct3D-Runtime zum Verwalten eines Sitzungsschlüssels und zum Ausführen von Kryptovorgängen in und aus geschütztem Arbeitsspeicher verwendet.

Syntax

PFND3DDDI_CREATECRYPTOSESSION Pfnd3dddiCreatecryptosession;

HRESULT Pfnd3dddiCreatecryptosession(
  HANDLE hDevice,
  D3DDDIARG_CREATECRYPTOSESSION *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData [in, out]

Ein Zeiger auf eine D3DDDIARG_CREATECRYPTOSESSION-Struktur . Bei der Eingabe enthält diese Struktur Informationen, die der Treiber verwenden kann. In der Ausgabe gibt der Treiber Informationen in der Struktur an, die die Microsoft Direct3D-Runtime verwenden kann.

Rückgabewert

CreateCryptoSession gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Die Kryptositzung wurde erfolgreich erstellt.
E_OUTOFMEMORY CreateCryptoSession konnte nicht den erforderlichen Arbeitsspeicher zuordnen, um es abzuschließen.
D3DDDIERR_NOTAVAILABLE Der Treiber unterstützt nicht die GUID, die im CryptoTypemember der D3DDDIARG_CREATECRYPTOSESSION-Struktur angegeben ist, oder die NULL_GUID (alle Nullen) wird im CryptoTypemember angegeben.
D3DDDIERR_UNSUPPORTEDCRYPTO Der Treiber unterstützt den Kryptotyp für den angegebenen Decodierungstyp nicht.

Hinweise

Wenn das DecodeProfile-Element der D3DDDIARG_CREATECRYPTOSESSION-Struktur NULL_GUID ist, wird die Krypto-Sitzung nicht für die DirectX-Videobeschleunigung (DirectX VA)-Decodierung verwendet. Wenn DecodeProfile keine NULL-GUID ist, sollte der Treiber mit D3DDDIERR_UNSUPPORTEDCRYPTO fehlschlagen, wenn der Kryptografietyp im CryptoType-Member vom Decodierungsprofil nicht unterstützt wird.

Der Treiber gibt ein Handle für die Kryptositzung im hCryptoSession-Mitglied von D3DDDIARG_CREATECRYPTOSESSION zurück, das die Laufzeit in allen nachfolgenden Kryptositzungsaufrufen (z. B. CryptoSessionKeyExchange) übergibt.

Der Treiber muss das Anzeigegerät (hDevice) nachverfolgen, das zum Erstellen der Kryptositzung verwendet wurde. Der Treiber sollte bei allen nachfolgenden Aufrufen, die diese erstellte Kryptositzung verwenden, fehlschlagen, wenn sich das in diesen Aufrufen angegebene Anzeigegerät von dem Anzeigegerät unterscheidet, das zum Erstellen der Kryptositzung verwendet wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt ab Windows 7.
Zielplattform Desktop
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

CryptoSessionKeyExchange

D3DDDIARG_CREATECRYPTOSESSION