structure OPM_CONFIGURE_PARAMETERS (opmapi.h)

  • Article

Contient une commande OPM (Output Protection Manager ) ou Copp (Certified Output Protection Manager).

Syntaxe

typedef struct _OPM_CONFIGURE_PARAMETERS {
  OPM_OMAC omac;
  GUID     guidSetting;
  ULONG    ulSequenceNumber;
  ULONG    cbParametersSize;
  BYTE     abParameters[4056];
} OPM_CONFIGURE_PARAMETERS;

Membres

omac

Structure OPM_MAC . Renseignez cette structure avec le code MAC (Message Authentication Code) des données de commande. Utilisez un MAC CBC (OMAC) basé sur AES pour calculer cette valeur.

guidSetting

GUID qui spécifie la commande . Pour plus d’informations, consultez Commandes OPM.

ulSequenceNumber

Numéro de séquence de commande. L’application doit conserver le nombre d’exécutions des commandes émises. Pour chaque commande, incrémentez le numéro de séquence d’un.

Lors du premier appel à IOPMVideoOutput ::Configure, définissez ulSequenceNumber égal au numéro de séquence de la commande de démarrage, qui est spécifié lorsque l’application appelle IOPMVideoOutput ::FinishInitialization. À chaque appel suivant, incrémentez ulSequenceNumber par 1.

Exception : si la méthode IOPMVideoOutput ::Configure échoue, n’incrémentez pas le numéro de séquence. Au lieu de cela, réutiliser le même nombre pour la commande suivante.

cbParametersSize

Nombre d’octets de données valides dans le membre abParameters .

abParameters[4056]

Données de la commande. La signification des données dépend de la commande . Pour plus d’informations, consultez Commandes OPM.

Remarques

La disposition de cette structure est identique à la structure AMCOPPCommand utilisée dans le protocole COPP (Certified Output Protection Protocol).

Initialisez cette structure comme suit.

  1. Renseignez tous les membres de la structure à l’exception du membre omac .
  2. Utilisez l’algorithme OMAC 1 pour calculer un code d’authentification de message (MAC) pour le bloc de données qui apparaît après le membre omac (à l’exclusion du membre omac ).
  3. Copiez le MAC dans le membre omac .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête opmapi.h

Voir aussi

IOPMVideoOutput ::Configure

OPM Structures

Gestionnaire de protection de sortie