structure DXGKMDT_OPM_GET_INFO_PARAMETERS (d3dkmdt.h)

Article
08/07/2023

La structure DXGKMDT_OPM_GET_INFO_PARAMETERS contient des paramètres utilisés pour récupérer des informations à partir d’un objet de sortie protégé dans un appel à la fonction DxgkDdiOPMGetInformation .

Syntaxe

typedef struct _DXGKMDT_OPM_GET_INFO_PARAMETERS {
  DXGKMDT_OPM_OMAC          omac;
  DXGKMDT_OPM_RANDOM_NUMBER rnRandomNumber;
  GUID                      guidInformation;
  ULONG                     ulSequenceNumber;
  ULONG                     cbParametersSize;
  BYTE                      abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE];
} DXGKMDT_OPM_GET_INFO_PARAMETERS, *PDXGKMDT_OPM_GET_INFO_PARAMETERS;

Membres

omac

Structure de DXGKMDT_OPM_OMAC qui contient un code d’authentification de message en mode Chaîne de blocs à une clé (CBC) pour l’authenticité du message. 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 = Clé 128 bits que le pilote miniport d’affichage reçoit quand DxgkDdiOPMSetSigningKeyAndSequenceNumbers est appelée.

n = 128 bits

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

rnRandomNumber

Une structure DXGKMDT_OPM_RANDOM_NUMBER qui contient le nombre aléatoire sécurisé de 128 bits d’un objet de sortie protégé. Ce nombre aléatoire est généré par une application et fourni au pilote miniport d’affichage dans rnRandomNumber dans un appel à la fonction DxgkDdiOPMGetInformation du pilote.

guidInformation

GUID utilisé pour récupérer les informations. guidInformation peut être défini sur l’un des GUID suivants :

DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION
DXGKMDT_OPM_GET_CONNECTOR_TYPE
DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES
DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL
DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL
DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT
DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE
DXGKMDT_OPM_GET_DVI_CHARACTERISTICS. Pris en charge dans Windows 7 et versions ultérieures.
DXGKMDT_OPM_GET_OUTPUT_ID. Pris en charge dans Windows 7 et versions ultérieures.

ulSequenceNumber

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

cbParametersSize

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

abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]

Tableau de 4 056 octets qui contient les données qui accompagnent la demande d’informations identifiée par le membre guidInformation .

Aucune donnée n’est requise pour les demandes DXGKMDT_OPM_GET_CONNECTOR_TYPE, DXGKMDT_OPM_GET_SUPPORTED_PROTECTION_TYPES, DXGKMDT_OPM_GET_ACTUAL_OUTPUT_FORMAT, DXGKMDT_OPM_GET_ADAPTER_BUS_TYPE, DXGKMDT_OPM_GET_DVI_CHARACTERISTICS, DXGKMDT_OPM_GET_OUTPUT_ID et DXGKMDT_OPM_GET_CURRENT_HDCP_SRM_VERSION.

Les demandes DXGKMDT_OPM_GET_ACTUAL_PROTECTION_LEVEL et DXGKMDT_OPM_GET_VIRTUAL_PROTECTION_LEVEL nécessitent des données qui identifient le type de protection pour lequel le niveau de protection est demandé. Par conséquent, ces demandes nécessitent que les 4 premiers octets du tableau abParameters contiennent le type de protection.

Remarques

Toutes les données après la signature du membre omac dans DXGKMDT_OPM_GET_INFO_PARAMETERS ; la signature est l’OMAC et est stockée dans le membre omac . Les données sont signées à l’aide de l’algorithme OMAC-1.

DXGKMDT_OPM_GET_INFO_PARAMETERS n’est pas utilisé pour l’émulation COPP ; à la place, la structure DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS est utilisée pour COPP.