Méthode IOPMVideoOutput ::StartInitialization (opmapi.h)

  • Article

Commence la séquence d’initialisation d’une session Output Protection Manager (OPM).

Syntaxe

HRESULT StartInitialization(
  [out] OPM_RANDOM_NUMBER *prnRandomNumber,
  [out] BYTE              **ppbCertificate,
  [out] ULONG             *pulCertificateLength
);

Paramètres

[out] prnRandomNumber

Pointeur vers une structure OPM_RANDOM_NUMBER . La structure reçoit un nombre aléatoire 128 bits généré par le pilote d’affichage. Ce nombre est requis pour la méthode IOPMVideoOutput ::FinishInitialization .

[out] ppbCertificate

Reçoit un pointeur vers une mémoire tampon contenant le certificat du pilote d’affichage. La méthode alloue la mémoire pour la mémoire tampon. L’appelant doit libérer la mémoire en appelant CoTaskMemFree.

[out] pulCertificateLength

Reçoit la longueur de la mémoire tampon pointée vers ppbCertificate.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode équivaut à la méthode IAMCertifiedOutputProtection ::KeyExchange dans le protocole COPP (Certified Output Protection Protocol).

La méthode retourne une chaîne de certificats qui contient la clé publique RSA 2048 bits du pilote. L’appelant doit valider la chaîne de certificats, puis appeler IOPMVideoOutput ::FinishInitialization pour établir la session OPM.

Cette méthode prend en charge à la fois la sémantique OPM et la sémantique COPP. La sémantique COPP est prise en charge pour la compatibilité descendante ; les nouvelles applications doivent utiliser la sémantique OPM.

Sémantique OPM

La méthode retourne une chaîne de certificats X.509. La chaîne de certificats est encodée avec ASN.1 Distinguished Encoding Rules (DER).

Sémantique COPP

La méthode retourne une chaîne de certificats COPP. La chaîne de certificats est retournée sous forme de chaîne UTF-8. Vous pouvez traiter la mémoire tampon retournée dans ppbCertificate comme un tableau de caractères.

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]
Plateforme cible Windows
En-tête opmapi.h

Voir aussi

IOPMVideoOutput

Gestionnaire de protection de sortie