structure OPM_GET_INFO_PARAMETERS (ksopmapi.h)

  • Article

Contient les paramètres de la méthode IOPMVideoOutput::GetInformation .

Syntaxe

typedef struct _OPM_GET_INFO_PARAMETERS {
  OPM_OMAC          omac;
  OPM_RANDOM_NUMBER rnRandomNumber;
  GUID              guidInformation;
  ULONG             ulSequenceNumber;
  ULONG             cbParametersSize;
  BYTE              abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE];
} OPM_GET_INFO_PARAMETERS;

Membres

omac

Une structure OPM_OMAC qui contient un code d’authentification de message (MAC) pour les données dans le reste de la structure.

rnRandomNumber

Une structure OPM_RANDOM_NUMBER qui contient un nombre aléatoire de 128 bits sécurisé par chiffrement.

guidInformation

GUID qui définit la demande status. Pour plus d’informations, consultez Demandes d’état OPM.

ulSequenceNumber

Numéro de séquence status. L’application doit conserver un nombre de requêtes en cours d’exécution status. Pour chaque requête, incrémentez le numéro de séquence de 1.

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

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

cbParametersSize

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

abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE]

Données de la demande de status. La signification des données dépend de la demande. Pour plus d’informations, consultez Demandes d’état OPM.

Notes

Initialisez cette structure comme suit :

  1. Générez un nombre aléatoire 128 bits sécurisé par chiffrement et copiez-le dans le membre rnRandomNumber . Ne réutiliser pas ce numéro après avoir appelé GetInformation.
  2. Renseignez les membres de structure restants, à l’exception du membre omac .
  3. 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 ).
  4. Copiez le MAC dans le membre omac .

Configuration requise

   
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 ksopmapi.h (inclure Opmapi.h)

Voir aussi

OPM Structures

Gestionnaire de protection de sortie