IAMCertifiedOutputProtection ::SessionSequenceStart, méthode (strmif.h)

  • Article

[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 SessionSequenceStart méthode lance la session COPP avec le pilote graphique.

Syntaxe

HRESULT SessionSequenceStart(
  [in] AMCOPPSignature *pSig
);

Paramètres

[in] pSig

Pointeur vers une structure AMCOPPSignature . Remplissez cette structure comme décrit dans la session Remarques.

Valeur retournée

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

Code de retour Description
S_OK
 Réussite.
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.
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.

Remarques

Pour remplir la structure du paramètre pSig , commencez par concaténer les nombres suivants :

  • Nombre 128 bits retourné dans le paramètre pRandom de la méthode IAMCertifiedOutputProtection ::KeyExchange .
  • Clé de session d’intégrité des données. Cette valeur est un nombre aléatoire 128 bits généré par l’application.
  • Numéro de séquence de départ pour les requêtes copp status. Cette valeur est un nombre aléatoire 32 bits généré par l’application.
  • Numéro de séquence de départ pour les commandes COPP. Cette valeur est un nombre aléatoire 32 bits généré par l’application.
Ensuite, chiffrez ce nombre avec un chiffrement RSA 2 048 bits à l’aide de la clé de chiffrement publique du pilote graphique. La clé de chiffrement publique est contenue dans le certificat retourné dans le paramètre VarLenCertGH de la méthode KeyExchange .

Configuration requise

Condition requise Valeur
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)