DXGKMDT_OPM_CONFIGURE_PARAMETERS-Struktur (d3dkmdt.h)

Artikel
08/07/2023

Die DXGKMDT_OPM_CONFIGURE_PARAMETERS-Struktur enthält Parameter, die zum Konfigurieren eines geschützten Ausgabeobjekts in einem Aufruf der DxgkDdiOPMConfigureProtectedOutput-Funktion verwendet werden.

Syntax

typedef struct _DXGKMDT_OPM_CONFIGURE_PARAMETERS {
  DXGKMDT_OPM_OMAC omac;
  GUID             guidSetting;
  ULONG            ulSequenceNumber;
  ULONG            cbParametersSize;
  BYTE             abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE];
} DXGKMDT_OPM_CONFIGURE_PARAMETERS, *PDXGKMDT_OPM_CONFIGURE_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 .

guidSetting

Die GUID, die zum Konfigurieren des geschützten Ausgabeobjekts verwendet wird. guidSetting kann auf eine der folgenden GUIDs festgelegt werden:

DXGKMDT_OPM_SET_PROTECTION_LEVEL
DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING
DXGKMDT_OPM_SET_HDCP_SRM
DXGKMDT_OPM_SET_PROTECTION_LEVEL_ACCORDING_TO_CSS_DVD. Unterstützt in Windows 7 und höheren Versionen.

ulSequenceNumber

Eine Sequenznummer. Damit die DxgkDdiOPMConfigureProtectedOutput-Funktion eine Konfigurationsanforderung verarbeiten kann, muss der Wert in ulSequenceNumber mit der aktuellen 4-Byte-Sequenznummer übereinstimmen, die der Anzeige-Miniporttreiber speichert. Wenn keine Übereinstimmung erkannt wird, gibt DxgkDdiOPMConfigureProtectedOutput einen Fehlercode zurück. Wenn eine Übereinstimmung erkannt wird, erhöht DxgkDdiOPMConfigureProtectedOutput vor der Rückgabe die gespeicherte Sequenznummer. Die anfängliche 4-Byte-Sequenznummer ist Teil des 256-Byte-Arrays, auf das der EncryptedParameters-Parameter der DxgkDdiOPMSetSigningKeyAndSequenceNumbers-Funktion verweist.

cbParametersSize

Die Größe der gültigen Konfigurationsdaten in Bytes, auf die der abParameters-Member verweist.

abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE]

Ein 4056-Byte-Array, das angibt, wie das geschützte Ausgabeobjekt konfiguriert wird.

Der abParameters-Parameter wird in eine der folgenden Strukturen umgewandelt, die die Konfigurationsinformationen enthält, abhängig von der GUID, die im guidSetting-Element von angegeben ist, DXGKMDT_OPM_CONFIGURE_PARAMETERS, auf die der Parameterparameter von DxgkDdiOPMConfigureProtectedOutput zeigt.

Dies sind mögliche GUIDs und Strukturen für Konfigurationsinformationen:

GUID	Struktur für abgerufene Informationen
DXGKMDT_OPM_SET_PROTECTION_LEVEL oder DXGKMDT_OPM_SET_PROTECTION_LEVEL_ACCORDING_TO_CSS_DVD	DXGKMDT_OPM_SET_PROTECTION_LEVEL_PARAMETERS
DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING	DXGKMDT_OPM_SET_ACP_AND_CGMSA_SIGNALING_PARAMETERS
DXGKMDT_OPM_SET_HDCP_SRM	DXGKMDT_OPM_SET_HDCP_SRM_PARAMETERS