DDICONTENTPROTECTIONCAPS-Struktur (d3dumddi.h)
Die DDICONTENTPROTECTIONCAPS-Struktur beschreibt eine bestimmte Verschlüsselungs- und Decodierungskombination, die der Treiber verwendet.
Syntax
typedef struct _DDICONTENTPROTECTIONCAPS {
[in] GUID CryptoType;
[in] GUID DecodeProfile;
} DDICONTENTPROTECTIONCAPS;
Member
[in] CryptoType
Eine GUID, die den vom Treiber verwendeten Verschlüsselungstyp angibt. Die derzeit definierten GUIDs sind:
D3DCRYPTOTYPE_AES128_CTR
Eine GUID, die die 128-Bit-AES-CRT-Blockchiffre angibt.
D3DCRYPTOTYPE_PROPRIETARY
Eine GUID, die einen proprietären Verschlüsselungsalgorithmus angibt.
Ein NULL-Wert gibt an, dass keine Verschlüsselung verwendet wird.
[in] DecodeProfile
Eine GUID, die das DirectX-Videobeschleunigungsprofil (DirectX VA) angibt, das der Treiber zusammen mit dem Verschlüsselungstyp verwendet, den das CryptoType-Mitglied angibt. Nicht alle Treiber lassen alle Verschlüsselungstypen zu. Mpeg2 IDCT erfordert beispielsweise häufig, dass die privaten Bibliotheken, die der Hardwareanbieter bereitstellt, die proprietäre Verschlüsselung durchführen. Ein NULL-Wert gibt an, dass das DirectX VA-Decodierungsprofil nicht verwendet wird.
Hinweise
Die Runtime gibt einen Zeiger auf eine DDICONTENTPROTECTIONCAPS-Struktur im pInfo-Member der D3DDDIARG_GETCAPS-Struktur an - zusammen mit dem D3DDDICAPS_GETCONTENTPROTECTIONCAPS-Wert im Type-Member von D3DDDIARG_GETCAPS - in einem Aufruf der GetCaps-Funktion des Benutzermodusanzeigetreibers, um die vom Treiber unterstützten Funktionen für den Inhaltsschutz zu bestimmen. GetCaps des Treibers gibt einen Zeiger auf eine aufgefüllte D3DCONTENTPROTECTIONCAPS-Struktur im pData-Member von D3DDDIARG_GETCAPS zurück, der die vom Treiber unterstützten Inhaltsschutzfunktionen beschreibt. Eine Anwendung ruft die IDirect3DDevice9Video::GetContentProtectionCaps-Methode auf, um diese Inhaltsschutzfunktionen abzurufen. Weitere Informationen zu IDirect3DDevice9Video::GetContentProtectionCaps und D3DCONTENTPROTECTIONCAPS finden Sie in der DirectX SDK-Dokumentation.
Wenn die Runtime in DecodeProfile NULL_GUID (alle Nullen) angibt, sollte der Treiber die Inhaltsschutzfunktionen zurückgeben, die für den Zeitpunkt der Nichtbenutzung eines DirectX VA-Decodierungsprofils relevant sind. Diese Inhaltsschutzfunktionen entsprechen den DDI-Funktionen für den Inhaltsschutz, die der Treiber optional implementiert. Weitere Informationen zu diesen optionalen Funktionen finden Sie unter Content Protection DDI.
Wenn der im CryptoType-Member angegebene Verschlüsselungstyp von der Grafikhardware und dem Treiber unterstützt wird, aber nicht vom DirectX VA-Decodierungsprofil unterstützt wird, das im DecodeProfile-Member angegeben ist, sollte die GetCaps-Funktion des Treibers D3DDDIERR_UNSUPPORTEDCRYPTO zurückgeben. Wenn der im CryptoType-Member angegebene Verschlüsselungstyp überhaupt nicht unterstützt wird, sollte die GetCaps-Funktion des Treibers D3DDDIERR_NOTAVAILABLE zurückgeben.
Wenn die Runtime NULL_GUID im CryptoType-Member angibt, sollte der Treiber eine Übermenge seiner Inhaltsschutzfunktionen melden. Wenn der Verschlüsselungstyp A beispielsweise einige Funktionen unterstützt und der Verschlüsselungstyp B einige andere Funktionen unterstützt, sollte der Treiber die kumulativen Funktionen zurückgeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | DDICONTENTPROTECTIONCAPS wird ab dem Windows 7-Betriebssystem unterstützt. |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |