PFND3DDDI_CREATECRYPTOSESSION Rückruffunktion (d3dumddi.h)
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) |