struttura DXGKMDT_OPM_CONFIGURE_PARAMETERS (d3dkmdt.h)

Articolo
02/06/2025

La struttura DXGKMDT_OPM_CONFIGURE_PARAMETERS contiene parametri usati per configurare un oggetto di output protetto in una chiamata alla funzione DxgkDdiOPMConfigureProtectedOutput.

Sintassi

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;

Membri

omac

Struttura DXGKMDT_OPM_OMAC che contiene un codice OMAC (Cipher Block Chaining) in modalità one-key per l'autenticità dei messaggi. Per altre informazioni su OMAC, vedere l'algoritmo OMAC-1 . I parametri OMAC-1 usati da OPM e COPP sono:

E = AES (Advanced Encryption Standard)

t = 128 bit

K = Il tasto a 128 bit ricevuto dal driver miniport di visualizzazione quando viene chiamato DxgkDdiOPMSetSigningKeyAndSequenceNumbers.

n = 128 bit

Per informazioni su AES, vedere il sito Web RSA Laboratories.

guidSetting

GUID utilizzato per configurare l'oggetto di output protetto. guidSetting può essere impostato su uno dei GUID seguenti:

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. Supportato in Windows 7 e versioni successive.

ulSequenceNumber

Numero di sequenza. Per la funzione DxgkDdiOPMConfigureProtectedOutput per elaborare una richiesta di configurazione, il valore in ulSequenceNumber deve corrispondere al numero di sequenza a 4 byte corrente archiviato dal driver miniport. Se non viene rilevata una corrispondenza, DxgkDdiOPMConfigureProtectedOutput restituisce un codice di errore. Se viene rilevata una corrispondenza, DxgkDdiOPMConfigureProtectedOutput incrementa il numero di sequenza archiviato prima di restituire. Il numero di sequenza iniziale a 4 byte fa parte della matrice a 256 byte a cui punta la EncryptedParameters parametro della funzione DxgkDdiOPMSetSigningKeyAndSequenceNumbers.

cbParametersSize

Dimensioni, in byte, dei dati di configurazione validi a cui punta l'abParameters membro.

abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE]

Matrice a 4056 byte che specifica come configurare l'oggetto di output protetto.

Il cast del parametro abParameters a una delle strutture seguenti che contiene le informazioni di configurazione, a seconda del GUID specificato nel guidSetting membro di DXGKMDT_OPM_CONFIGURE_PARAMETERS a cui punta il parametro parameters di DxgkDdiOPMConfigureProtectedOutput.

Si tratta di possibili GUID e strutture per le informazioni di configurazione:

GUID	Struttura per le informazioni recuperate
DXGKMDT_OPM_SET_PROTECTION_LEVEL o 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