PFND3DDDI_CREATECRYPTOSESSION Rückruffunktion (d3dumddi.h)
Die CreateCryptoSession Funktion erstellt eine Kryptositzung, die von der Direct3D-Runtime zum Verwalten eines Sitzungsschlüssels und zum Ausführen von Kryptovorgängen in und außerhalb des geschützten Speichers verwendet wird.
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. Bei der Ausgabe gibt der Treiber Informationen in der Struktur an, die von der Microsoft Direct3D-Laufzeit verwendet werden kann.
Rückgabewert
CreateCryptoSession gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Krypto-Sitzung wurde erfolgreich erstellt. |
| E_OUTOFMEMORY | CreateCryptoSession- konnte den erforderlichen Speicher nicht zuordnen, damit er abgeschlossen werden kann. |
| D3DDDIERR_NOTAVAILABLE | Der Treiber unterstützt 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. |
Bemerkungen
Wenn das DecodeProfile Mitglied der D3DDDIARG_CREATECRYPTOSESSION Struktur NULL_GUID ist, wird die Kryptositzung nicht für directX Video Acceleration (DirectX VA) Decodierung verwendet. Wenn DecodeProfile- nicht NULL- GUID ist, sollte der Treiber mit D3DDDIERR_UNSUPPORTEDCRYPTO fehlschlagen, wenn der Kryptotyp im CryptoType Member vom Decodierungsprofil nicht unterstützt wird.
Der Treiber gibt einen Handle für die Kryptositzung in der hCryptoSession Mitglied von D3DDDIARG_CREATECRYPTOSESSION zurück, dass die Laufzeit alle nachfolgenden Krypto-Sitzungsaufrufe übergibt (z. B. CryptoSessionKeyExchange).
Der Treiber muss das Anzeigegerät (hDevice) nachverfolgen, das zum Erstellen der Kryptositzung verwendet wurde. Der Treiber sollte alle nachfolgenden Aufrufe, die diese erstellte Kryptositzung verwenden, fehlschlagen, wenn das in diesen Anrufen angegebene Anzeigegerät vom Anzeigegerät unterscheidet, das zum Erstellen der Kryptositzung verwendet wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 7 unterstützt. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |