DXGKMDT_OPM_CONFIGURE_PARAMETERS Struktur (d3dkmdt.h)

Artikel
02/06/2025

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;

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 für die Anzeige empfängt, wenn DxgkDdiOPMSetSigningKeyAndSequenceNumbers aufgerufen wird.

n = 128 Bit

Informationen zu AES finden Sie auf der Website RSA Laboratories.

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 konfigurierende Anforderung verarbeiten kann, muss der Wert in ulSequenceNumber mit der aktuellen 4-Byte-Sequenznummer übereinstimmen, die der Anzeigeminiporttreiber speichert. Wenn keine Übereinstimmung erkannt wird, gibt DxgkDdiOPMConfigureProtectedOutput einen Fehlercode zurück. Wenn eine Übereinstimmung erkannt wird, DxgkDdiOPMConfigureProtectedOutput die gespeicherte Sequenznummer erhöht, bevor sie zurückgegeben wird. Die erste 4-Byte-Sequenznummer ist Teil des 256-Byte-Arrays, auf das der EncryptedParameters Parameter des DxgkDdiOPMSetSigningKeyAndSequenceNumbers Funktion verweist.

cbParametersSize

Die Größe der gültigen Konfigurationsdaten, 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 Parameter wird in eine der folgenden Strukturen umgewandelt, die die Konfigurationsinformationen enthalten, abhängig von der GUID, die im guidSetting-Element Member von DXGKMDT_OPM_CONFIGURE_PARAMETERS angegeben ist, auf die der Parameters Parameter von DxgkDdiOPMConfigureProtectedOutput verweist.

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