structure OPM_CONFIGURE_PARAMETERS (opmapi.h)
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.
- Renseignez tous les membres de la structure à l’exception du membre omac .
- 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 ).
- 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 |