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;
Angehörige
omac
Eine DXGKMDT_OPM_OMAC Struktur, die einen CBC-Modus (Cipher Block Chaining)-Code (CBC)-Modus für die Nachrichtenauthentifizierung (Message Authentication Code, OMAC) für die Nachrichtenauthentifizierung 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 Bit
K = Die 128-Bit-Taste, die der Miniporttreiber empfängt, wenn DxgkDdiOPMSetSigningKeyAndSequenceNumbers aufgerufen wird.
n = 128 Bit
Informationen zu AES finden Sie auf der Website RSA Laboratories.
rnRandomNumber
Eine DXGKMDT_OPM_RANDOM_NUMBER Struktur, die die 128-Bit-Zufallszahl eines geschützten Ausgabeobjekts enthält. Diese Zufallszahl wird von einer Anwendung generiert und dem Anzeigeminiporttreiber 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 Anzeigeminiporttreiber speichert. Wenn keine Übereinstimmung erkannt wird, gibt DxgkDdiOPMGetInformation einen Fehlercode zurück. Wenn eine Übereinstimmung erkannt wird, DxgkDdiOPMGetInformation die gespeicherte Sequenznummer vor der Rückgabe erhöht. Die ursprüngliche 4-Byte-Sequenznummer war Teil des 256-Byte-Arrays, auf das die EncryptedParameters Parameter des DxgkDdiOPMSetSigningKeyAndSequenceNumbers Funktion verweist.
cbParametersSize
Die Größe der gültigen Daten, auf die der abParameters Member verweist, in Byte.
abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]
Ein 4056-Byte-Array, das die Daten enthält, die die Informationsanforderung begleiten, die vom guidInformation Member 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.
Für die anforderungen DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL und DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL sind Daten erforderlich, die den Schutztyp identifizieren, für den die Schutzebene angefordert wird. Daher erfordern diese Anforderungen, dass die ersten 4 Byte im abParameters Array den Schutztyp enthalten.
Bemerkungen
Alle Daten, nachdem das omac Mitglied in DXGKMDT_OPM_GET_INFO_PARAMETERS signiert wurde; die Signatur ist der OMAC und wird im omac Mitglied gespeichert. Die Daten werden mit dem OMAC-1-Algorithmussigniert.
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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Header- | d3dkmdt.h |