DXGKMDT_OPM_CONFIGURE_PARAMETERS structure (d3dkmdt.h)

Article
08/07/2023

La structure DXGKMDT_OPM_CONFIGURE_PARAMETERS contient des paramètres utilisés pour configurer un objet de sortie protégé dans un appel à la fonction DxgkDdiOPMConfigureProtectedOutput .

Syntaxe

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;

Membres

omac

Structure de DXGKMDT_OPM_OMAC qui contient un code d’authentification de message (OMAC) en mode Chaîne de blocs de chiffrement à clé unique (OMAC) pour l’authenticité des messages. Pour plus d’informations sur OMAC, consultez l’algorithme OMAC-1. Les paramètres OMAC-1 utilisés par OPM et COPP sont les suivants :

E = AES (Advanced Encryption Standard)

t = 128 bits

K = touche 128 bits que le pilote de miniport d’affichage reçoit lorsque DxgkDdiOPMSetSigningKeyAndSequenceNumbers est appelé.

n = 128 bits

Pour plus d’informations sur AES, consultez le site web RSA Laboratories .

guidSetting

GUID utilisé pour configurer l’objet de sortie protégé. guidSetting peut être défini sur l’un des GUID suivants :

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. Pris en charge dans Windows 7 et versions ultérieures.

ulSequenceNumber

Numéro séquentiel. Pour que la fonction DxgkDdiOPMConfigureProtectedOutput traite une demande de configuration, la valeur dans ulSequenceNumber doit correspondre au numéro séquentiel de 4 octets actuel que le pilote de miniport d’affichage stocke. Si aucune correspondance n’est détectée, DxgkDdiOPMConfigureProtectedOutput retourne un code d’erreur. Si une correspondance est détectée, DxgkDdiOPMConfigureProtectedOutput incrémente le numéro de séquence stocké avant de retourner. Le numéro séquentiel initial de 4 octets fait partie du tableau de 256 octets vers lequel pointe le paramètre EncryptedParameters de la fonction DxgkDdiOPMSetSigningKeyAndSequenceNumbers .

cbParametersSize

Taille, en octets, des données de configuration valides vers laquelle pointe le membre abParameters .

abParameters[DXGKMDT_OPM_CONFIGURE_SETTING_DATA_SIZE]

Tableau de 4 056 octets qui spécifie comment configurer l’objet de sortie protégé.

Le paramètre abParameters est converti en une des structures suivantes qui contient les informations de configuration, en fonction du GUID spécifié dans le membre guidSetting de DXGKMDT_OPM_CONFIGURE_PARAMETERS vers lequel pointe le paramètre Parameters de DxgkDdiOPMConfigureProtectedOutput .

Voici les GUID et structures possibles pour les informations de configuration :

GUID	Structure des informations récupérées
DXGKMDT_OPM_SET_PROTECTION_LEVEL ou 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