struttura DXGKMDT_OPM_CONFIGURE_PARAMETERS (d3dkmdt.h)

Articolo
03/08/2023

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;

Members

omac

Struttura DXGKMDT_OPM_OMAC che contiene un codice OMAC (Message Authentication Code) in modalità CBC (One-Key Cipher Block Chaining) 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 = La chiave a 128 bit che il driver miniport visualizzato riceve 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 di visualizzazione. 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 il parametro EncryptedParameters della funzione DxgkDdiOPMSetSigningKeyAndSequenceNumbers .

cbParametersSize

Dimensione, in byte, dei dati di configurazione validi a cui punta il membro abParameters .

abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE]

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

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

Sono 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