structure DXGKMDT_OPM_GET_INFO_PARAMETERS (d3dkmdt.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| En-tête | d3dkmdt.h |