Méthode IOPMVideoOutput ::StartInitialization (opmapi.h)
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 |