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

  • 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.]

Cette section décrit les requêtes status 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 GUID
Données de bus DXVA_COPPQueryBusData
Type de connecteur DXVA_COPPQueryConnectorType
Afficher les données DXVA_COPPQueryDisplayData
Données clés HDCP DXVA_COPPQueryHDCPKeyData
Niveau de protection global DXVA_COPPQueryGlobalProtectionLevel
Niveau de protection local DXVA_COPPQueryLocalProtectionLevel
Protection Type DXVA_COPPQueryProtectionType
Signalisation DXVA_COPPQuerySignaling

 

Requête de données bus

Retourne le type de bus d’E/S utilisé par la carte graphique.

  • GUID : DXVA_COPPQueryBusData
  • Données d’entrée : Aucune.
  • Retourner des données : renvoie une structure 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
  • Données d’entrée : Aucune.
  • Retourner des données : renvoie une structure 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 via le connecteur.

Le signal vidéo transmis via 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 retournerait la résolution du signal S-Video, et non la résolution du bureau.

  • GUID : DXVA_COPPQueryDisplayData
  • Données d’entrée : Aucune.
  • Données de retour : renvoie une structure 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 de configuration HDCP. L’application doit case activée cette valeur par rapport à la liste des KSV révoqués. Le mécanisme d’obtention de la liste de révocation KSV n’entre pas dans le cadre 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.

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 LEP.

  • 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 : renvoie une structure 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 du 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 niveau de protection local

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

Le niveau de protection local est le niveau de protection qui a été demandé par le biais de la session COPP actuelle. Le pilote peut définir un niveau de protection plus élevé.

  • GUID : DXVA_COPPQueryLocalProtectionLevel

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

  • Retourner des données : renvoie une structure 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 du 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
  • Données d’entrée : Aucune.
  • Données de retour : renvoie une structure 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 un OR au 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.

Utilisation du protocole COPP (Certified Output Protection Protocol)