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 DXGKMDT_OPM_OMAC qui contient un code d’authentification de message en mode SRC (One-Key Cipher Block Chaining) 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 = La clé 128 bits que le pilote display miniport reçoit lorsque DxgkDdiOPMSetSigningKeyAndSequenceNumbers est appelée.
n = 128 bits
Pour plus d’informations sur AES, consultez le site web rsa Laboratories.
rnRandomNumber
Structure DXGKMDT_OPM_RANDOM_NUMBER qui contient un nombre aléatoire sécurisé par chiffrement 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’une des GUID suivantes :
- 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 de séquence. Pour la fonction DxgkDdiOPMGetInformation pour traiter une demande d’informations, la valeur dans ulSequenceNumber doit correspondre au numéro de séquence de 4 octets actuel que le miniport driver stores display. 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 4 octets initial faisait partie du tableau de 256 octets auquel la fonction EncryptedParameters du paramètre DxgkDdiOPMSetSigningKeyAndSequenceNumbers fonction pointée.
cbParametersSize
Taille, en octets, des données valides vers laquelle les abParameters membre pointe vers.
abParameters[DXGKMDT_OPM_GET_INFORMATION_PARAMETERS_SIZE]
Tableau d’octets 4056 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 requêtes 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 requêtes 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 requêtes nécessitent que les 4 premiers octets dans les abParameters tableau 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 ; Au lieu de cela, la structure DXGKMDT_OPM_COPP_COMPATIBLE_GET_INFO_PARAMETERS est utilisée pour COPP.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| d’en-tête | d3dkmdt.h |