Informations de référence sur les requêtes COPP

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngineet audio/vidéo capture dans 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 capture audio/vidéo dans Media Foundation au lieu de directShow, lorsque cela est 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.]

Cette section décrit les requêtes d’état prises en charge par le protocole COPP (Certified Output Protection Protocol). Pour chaque requête, le GUID qui définit la requête est répertorié, ainsi que les données d’entrée et les données de retour.

Requête de données bus

Retourne le type de bus d’E/S utilisé par l’adaptateur graphique.

• GUID: DXVA_COPPQueryBusData
• de données d’entrée : Aucun.
• retourner des données: retourne une structure de DXVA_COPPStatusData. Le type de bus est retourné dans le membre dwData en tant qu’indicateur de l’énumération COPP_BusType.

Requête de type de connecteur

Retourne le type de connecteur physique.

• GUID: DXVA_COPPQueryConnectorType
• de données d’entrée : Aucun.
• retourner des données: retourne une structure de DXVA_COPPStatusData. Le type de connecteur est retourné dans le membre dwData en tant qu’indicateur de l’énumération COPP_ConnectorType.

Afficher la requête de données

Retourne une description du signal vidéo transmis sur le connecteur.

Le signal vidéo transmis sur le connecteur n’a pas nécessairement le même format que le mode d’affichage du bureau. Par exemple, le mode d’affichage du bureau peut être de 1024 x 768 pixels à 85 Hz, tandis que le connecteur peut être un connecteur S-Video qui transmet un signal vidéo à 720 x 480 pixels, 60/1,01 Hz entrelacé. Dans ce cas, le pilote retourne la résolution du signal S-Video, et non la résolution du bureau.

• GUID: DXVA_COPPQueryDisplayData
• de données d’entrée : Aucun.
• retourner des données: retourne une structure de DXVA_COPPStatusDisplayData.

Requête de données clés HDCP

Retourne le vecteur de sélection de clé HDCP de l’appareil (B-KSV).

Le KSV est un identificateur fourni au fabricant de l’appareil et est utilisé dans le processus d’authentification et d’installation HDCP. L’application doit vérifier cette valeur par rapport à la liste des KSV révoqués. Le mécanisme d’obtention de la liste de révocation KSV est en dehors de l’étendue du protocole COPP. Pour plus d’informations, consultez la spécification HDCP.

Cette requête détermine également si l’appareil HDCP connecté est un moniteur ou un répéteur HDCP. L’application ne doit pas lire de contenu protégé si l’appareil HDCP est un répéteur HDCP, car ceux-ci ne sont pas pris en charge par COPP.

• GUID: DXVA_COPPQueryHDCPKeyData
• de données d’entrée : Aucun.
• retourner des données: retourne une structure de DXVA_COPPStatusHDCPKeyData.

Requête de niveau de protection globale

Retourne le niveau de protection global pour un mécanisme de protection spécifié.

Le niveau de protection global est le niveau de protection actuellement appliqué sur le connecteur, quelle que soit la façon dont le pilote graphique a été chargé d’appliquer la protection. Par exemple, une application peut définir le niveau de protection ACP en appelant la fonction ChangeDisplaySettingsEx. Dans ce cas, le niveau de protection global refléterait ce paramètre, même s’il n’a pas été demandé par l’intermédiaire de LA COPP.

• GUID: DXVA_COPPQueryGlobalProtectionLevel

• données d’entrée: mécanisme de protection à interroger, spécifié sous la forme d’un entier 32 bits. Consultez indicateurs de type de protection COPP.

• retourner des données: retourne une structure de DXVA_COPPStatusData. Le niveau de protection actuel est retourné dans le membre dwData. La signification de cette valeur dépend du mécanisme de protection interrogé. Pour chaque mécanisme de protection, la valeur de l'membre dwData est un indicateur d’une énumération différente, comme indiqué dans le tableau suivant.

  Mécanisme de protection	Énumération
  ACP	COPP_ACP_Protection_Level
  CGMS-A	COPP_CGMSA_Protection_Level
  HDCP	COPP_HDCP_Protection_Level

   

Requête au niveau de la protection locale

Retourne le niveau de protection local pour un mécanisme de protection spécifié.

Le niveau de protection local est le niveau de protection demandé par le biais de la session COPP actuelle. Le pilote peut définir un niveau de protection supérieur.

• GUID: DXVA_COPPQueryLocalProtectionLevel

• données d’entrée: mécanisme de protection à interroger, sous la forme d’un entier 32 bits. Consultez indicateurs de type de protection COPP.

• retourner des données: retourne une structure de DXVA_COPPStatusData. Le niveau de protection actuel est retourné dans le membre dwData. La signification de cette valeur dépend du mécanisme de protection interrogé. Pour chaque mécanisme de protection, la valeur de l'membre dwData est un indicateur d’une énumération différente, comme indiqué dans le tableau suivant.

  Mécanisme de protection	Énumération
  ACP	COPP_ACP_Protection_Level
  CGMS-A	COPP_CGMSA_Protection_Level
  HDCP	COPP_HDCP_Protection_Level

   

Requête de type de protection

Retourne les mécanismes de protection disponibles pour le connecteur.

• GUID: DXVA_COPPQueryProtectionType
• de données d’entrée : Aucun.
• retourner des données: retourne une structure de DXVA_COPPStatusData. Les mécanismes de protection sont retournés dans le membre dwData sous la forme d’une combinaison de zéro ou plusieurs indicateurs. Consultez indicateurs de type de protection COPP. Si plusieurs mécanismes de protection sont disponibles, les indicateurs sont combinés avec une OUau niveau du bit.

Requête de signalisation

Retourne une liste de toutes les normes de protection prises en charge par le pilote, la norme actuellement active et le rapport d’aspect actuel ou d’autres données de signalisation.

• GUID: DXVA_COPPQuerySignaling
• de données d’entrée : Aucun.
• retourner des données: retourne une structure de DXVA_COPPStatusSignalingCmdData.

Rubriques connexes

à l’aide du protocole COPP (Certified Output Protection Protocol)