IamCertifiedOutputProtection::KeyExchange, méthode (strmif.h)

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode KeyExchange retourne le certificat du pilote graphique.

Syntaxe

HRESULT KeyExchange(
  [out] GUID  *pRandom,
  [out] BYTE  **VarLenCertGH,
  [out] DWORD *pdwLengthCertGH
);

Paramètres

[out] pRandom

Reçoit un nombre aléatoire 128 bits, généré par le pilote graphique. Utilisez cette valeur dans la méthode IAMCertifiedOutputProtection::SessionSequenceStart .

[out] VarLenCertGH

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

[out] pdwLengthCertGH

Reçoit la longueur de la mémoire tampon retournée dans VarLenCertGH.

Valeur renvoyée

Retourne une valeur HRESULT. Les valeurs possibles sont les suivantes.

Code de retour	Description
S_OK	Opération réussie.
E_UNEXPECTED	État non valide. L’application a peut-être transmis des données inattendues ou appelé des méthodes IAMCertifiedOutputProtection dans le mauvais ordre. Si cette erreur se produit, l’application doit libérer la instance actuelle du VMR.
VFW_E_NO_COPP_HW	Le périphérique d’affichage ne prend pas en charge COPP ; ou le VMR ne s’est pas encore connecté à un périphérique d’affichage.
ERROR_GRAPHICS_NO_MONITORS_CORRESPOND_TO_DISPLAY_DEVICE	Aucun moniteur ne correspond au périphérique d’affichage. Cette erreur peut se produire si le mode d’affichage change ; ou l’utilisateur désactive un moniteur ou supprime un moniteur.

Notes

Le certificat du pilote graphique contient la clé de chiffrement publique du pilote.

Si cette méthode retourne E_UNEXPECTED, l’application doit créer une session COPP en libérant le VMR, en créant une nouvelle instance du VMR et en appelant KeyExchange à nouveau sur la nouvelle instance.

Configuration requise


Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

IAMCertifiedOutputProtection, interface

Utilisation du protocole COPP (Certified Output Protection Protocol)

Partager via