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

Weitere Informationen

D3DDDIARG_GETCAPS

GetCaps