structure DXVA_COPPStatusData (dxva.h)

Article
02/06/2025

La structure DXVA_COPPStatusData contient les informations d’état retournées par une requête sur une session vidéo protégée associée à un appareil DIRECTX VA COPP.

Syntaxe

typedef struct _DXVA_COPPStatusData {
  GUID  rApp;
  ULONG dwFlags;
  ULONG dwData;
  ULONG ExtendedInfoValidMask;
  ULONG ExtendedInfoData;
} DXVA_COPPStatusData;

Membres

rApp

Spécifie un nombre aléatoire 128 bits utilisé une seule fois. Ce nombre aléatoire est généré par l’application demandée et fourni au pilote d’affichage dans le membre rApp de la structure DXVA_COPPStatusInput.

dwFlags

Spécifie des informations d’état supplémentaires qui peuvent être pertinentes pour l’application appelante. Le pilote d’affichage doit définir dwFlags sur la valeur COPP_StatusNormal (0x00) du type d’énumération COPP_StatusFlags ou à une combinaison ORed valide de la COPP_StatusFlags suivante :

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

Spécifie les données d’état 32 bits retournées par l’une des requêtes suivantes transmises dans le paramètre pInput de la fonction COPPQueryStatus.

DXVA_COPPQueryProtectionType

Retourne une combinaison ORed valide des valeurs suivantes qui indiquent les types de mécanismes de protection disponibles sur le connecteur physique associé à un appareil COPP :

COPP_ProtectionType_Unknown (0x80000000)
COPP_ProtectionType_None (0x00)
COPP_ProtectionType_HDCP (0x01)
COPP_ProtectionType_ACP (0x02)
COPP_ProtectionType_CGMSA (0x04)

DXVA_COPPQueryConnectorType

Retourne l’une des valeurs suivantes du type d’énumération COPP_ConnectorType qui identifie le type de connecteur physique utilisé par la session vidéo :

COPP_ConnectorType_Unknown (-1)
COPP_ConnectorType_VGA (0)
COPP_ConnectorType_SVideo (1)
COPP_ConnectorType_CompositeVideo (2)
COPP_ConnectorType_ComponentVideo (3)
COPP_ConnectorType_DVI (4)
COPP_ConnectorType_HDMI (5)
COPP_ConnectorType_LVDS (6)
COPP_ConnectorType_TMDS (7)
COPP_ConnectorType_D_JPN (8)

La valeur COPP_ConnectorType_Internal (0x80000000) n’est combinée qu’à l’une des valeurs de type connecteur précédentes pour indiquer que la connexion entre l’adaptateur graphique et le moniteur d’affichage est permanente et non accessible à partir de l’extérieur d’un boîtier non serviceable par l’utilisateur.

DXVA_COPPQueryLocalProtectionLevel

Retourne le niveau de protection actuellement défini pour la session vidéo. La valeur au niveau de la protection dépend du type de protection spécifié dans l'StatusData membre de la structure DXVA_COPPStatusInput. Pour connaître les niveaux de protection possibles, consultez le membre ProtLevel de la structure DXVA_COPPSetProtectionLevelCmdData.

DXVA_COPPQueryGlobalProtectionLevel

Retourne le niveau de protection actuellement défini pour le connecteur physique. La valeur de niveau retournée doit refléter le niveau de protection actuellement appliqué via le connecteur, quelle que soit la façon dont le pilote a été invité à appliquer le niveau de protection. Par exemple, si l’ACP a été activé via la fonction ChangeDisplaySettingsEx win32 et non pas via l’interface IAMCertifiedOutputProtection, le niveau de protection global retourné par un appel à la fonction COPPQueryStatus pour le connecteur doit indiquer que l’ACP a été activé, même si l’ACP n’a pas été activé via l’interface IAMCertifiedOutputProtection.

La valeur au niveau de la protection dépend du type de protection spécifié dans l'StatusData membre de la structure DXVA_COPPStatusInput. Pour connaître les niveaux de protection possibles, consultez le membre ProtLevel de la structure DXVA_COPPSetProtectionLevelCmdData.

DXVA_COPPQueryBusData

Retourne l’une des valeurs suivantes du type d’énumération COPP_BusType qui identifie le type de bus utilisé par le matériel graphique associé à un appareil COPP :

COPP_BusType_Unknown (0)
COPP_BusType_PCI (1)
COPP_BusType_PCIX (2)
COPP_BusType_PCIExpress (3)
COPP_BusType_AGP (4)

La valeur COPP_BusType_Integrated (0x80000000) ne peut être combinée qu’à l’une des valeurs de type bus précédentes lorsqu’aucun signal d’interface de commande et d’état entre l’adaptateur graphique et d’autres sous-systèmes n’est disponible sur un bus d’extension qui utilise une spécification publique et un type de connecteur standard. Les bus mémoire sont exclus de cette définition.

ExtendedInfoValidMask

Spécifie une valeur qui indique les champs de bits valides dans le membre ExtendedInfoData suivant.

ExtendedInfoData

Spécifie des données 32 bits supplémentaires pour l’état. Non utilisé actuellement.

Remarques

Le pilote d’affichage retourne des informations d’état via le paramètre pOutput de COPPQueryStatus. La structure DXVA_COPPStatusOutput décrit les informations d’état retournées. Le pilote d’affichage doit convertir les informations d’état en pointeur vers une structure de DXVA_COPPStatusData et retourner les informations d’état dans le COPPStatus membre de DXVA_COPPStatusOutput.

Exigences

Exigence	Valeur
client minimum pris en charge	Cette structure s’applique uniquement à Windows Server 2003 avec SP1 et versions ultérieures, et Windows XP avec SP2 et versions ultérieures.
d’en-tête	dxva.h (include Dxva.h)