DXGKMDT_OPM_GET_INFO_PARAMETERS-Struktur (d3dkmdt.h)
Die DXGKMDT_OPM_GET_INFO_PARAMETERS-Struktur enthält Parameter, die zum Abrufen von Informationen aus einem geschützten Ausgabeobjekt in einem Aufruf der DxgkDdiOPMGetInformation-Funktion verwendet werden.
Syntax
typedef struct _DXGKMDT_OPM_GET_INFO_PARAMETERS {
DXGKMDT_OPM_OMAC omac;
DXGKMDT_OPM_RANDOM_NUMBER rnRandomNumber;
GUID guidInformation;
ULONG ulSequenceNumber;
ULONG cbParametersSize;
BYTE abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE];
} DXGKMDT_OPM_GET_INFO_PARAMETERS, *PDXGKMDT_OPM_GET_INFO_PARAMETERS;
Member
omac
Eine DXGKMDT_OPM_OMAC-Struktur , die einen Nachrichtenauthentifizierungscode (OMAC) im CBC-Modus (Cipher Block Chaining) für die Nachrichtenauthentizität enthält. Weitere Informationen zu OMAC finden Sie im OMAC-1-Algorithmus. Die OMAC-1-Parameter, die OPM und COPP verwenden, sind:
E = AES (Advanced Encryption Standard)
t = 128 Bits
K = Die 128-Bit-Taste, die der Anzeigeminiporttreiber empfängt, wenn DxgkDdiOPMSetSigningKeyAndSequenceNumbers aufgerufen wird.
n = 128 Bits
Informationen zu AES finden Sie auf der RSA Laboratories-Website .
rnRandomNumber
Eine DXGKMDT_OPM_RANDOM_NUMBER Struktur, die die kryptografisch sichere 128-Bit-Zufallszahl eines geschützten Ausgabeobjekts enthält. Diese Zufallszahl wird von einer Anwendung generiert und dem Anzeige-Miniporttreiber in rnRandomNumber in einem Aufruf der DxgkDdiOPMGetInformation-Funktion des Treibers bereitgestellt.
guidInformation
Die GUID, die zum Abrufen der Informationen verwendet wird. guidInformation kann auf eine der folgenden GUIDs festgelegt werden:
- DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION
- DXGKMDT_OPM_GET_CONNECTOR_TYPE
- DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES
- DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL
- DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL
- DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT
- DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE
- DXGKMDT_OPM_GET_DVI_CHARACTERISTICS. Unterstützt in Windows 7 und höheren Versionen.
- DXGKMDT_OPM_GET_OUTPUT_ID. Unterstützt in Windows 7 und höheren Versionen.
ulSequenceNumber
Eine Sequenznummer. Damit die DxgkDdiOPMGetInformation-Funktion eine Informationsanforderung verarbeiten kann, muss der Wert in ulSequenceNumber mit der aktuellen 4-Byte-Sequenznummer übereinstimmen, die der Displayporttreiber speichert. Wenn keine Übereinstimmung erkannt wird, gibt DxgkDdiOPMGetInformation einen Fehlercode zurück. Wenn eine Übereinstimmung erkannt wird, erhöht DxgkDdiOPMGetInformation vor der Rückgabe die gespeicherte Sequenznummer. Die anfängliche 4-Byte-Sequenznummer war Teil des 256-Byte-Arrays, auf das der EncryptedParameters-Parameter der DxgkDdiOPMSetSigningKeyAndSequenceNumbers-Funktion verweist.
cbParametersSize
Die Größe der gültigen Daten in Bytes, auf die der abParameters-Member verweist.
abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]
Ein 4056-Byte-Array, das die Daten enthält, die der Informationsanforderung beigefügt sind, die vom guidInformation-Element identifiziert wird.
Für die Anforderungen DXGKMDT_OPM_GET_CONNECTOR_TYPE, DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES, DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT, DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE, DXGKMDT_OPM_GET_DVI_CHARACTERISTICS, DXGKMDT_OPM_GET_OUTPUT_ID und DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION sind keine Daten erforderlich.
Die anforderungen DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL und DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL erfordern Daten, die den Schutztyp identifizieren, für den die Schutzebene angefordert wird. Daher erfordern diese Anforderungen, dass die ersten 4 Bytes im abParameters-Array den Schutztyp enthalten.
Hinweise
Alle Daten, nachdem das omac-Mitglied in DXGKMDT_OPM_GET_INFO_PARAMETERS signiert wurde; die Signatur ist der OMAC und wird im omac-Element gespeichert. Die Daten werden mit dem OMAC-1-Algorithmus signiert.
DXGKMDT_OPM_GET_INFO_PARAMETERS wird nicht für die COPP-Emulation verwendet. stattdessen wird die DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS-Struktur für COPP verwendet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Kopfzeile | d3dkmdt.h |