DXVA_COPPStatusData structure (dxva.h)

Article
08/07/2023

La structure DXVA_COPPStatusData contient les informations de status retournées par une requête sur une session vidéo protégée associée à un appareil COPP Va DirectX.

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 demande et fourni au pilote d’affichage dans le membre rApp de la structure DXVA_COPPStatusInput .

dwFlags

Spécifie des informations status 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 sur une combinaison ORed valide des COPP_StatusFlags suivantes :

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

Spécifie les données de status 32 bits retournées par l’une des requêtes suivantes passées 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) est uniquement combinée avec l’une des valeurs de type connecteur précédentes pour indiquer que la connexion entre la carte graphique et le moniteur d’affichage est permanente et n’est pas accessible à partir de l’extérieur d’un boîtier non utilisable par l’utilisateur.

DXVA_COPPQueryLocalProtectionLevel

Retourne le niveau de protection actuellement défini pour la session vidéo. La valeur du niveau de protection dépend du type de protection spécifié dans le membre StatusData 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é chargé d’appliquer le niveau de protection. Par exemple, si ACP a été activé via la fonction Win32 ChangeDisplaySettingsEx et non par le biais de l’interface IAMCertifiedOutputProtection , le niveau de protection global qui a été retourné via un appel à la fonction COPPQueryStatus pour le connecteur doit indiquer qu’ACP a été activé, même si ACP n’a pas été activé via l’interface IAMCertifiedOutputProtection .

La valeur du niveau de protection dépend du type de protection spécifié dans le membre StatusData 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’avec l’une des valeurs de type bus précédentes quand aucun des signaux de commande et d’interface status entre la carte graphique et d’autres sous-systèmes n’est disponible sur un bus d’extension qui utilise une spécification disponible publiquement 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 le status. Pas utilisé pour l'instant.

Remarques

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

Configuration requise

Condition requise	Valeur
Client minimal 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.
En-tête	dxva.h (inclure Dxva.h)