DXVA_COPPCommand structure (dxva.h)

Article
08/07/2023

La structure DXVA_COPPCommand décrit une commande envoyée à une session vidéo protégée associée à un appareil COPP DirectX VA.

Syntaxe

typedef struct _DXVA_COPPCommand {
  GUID  macKDI;
  GUID  guidCommandID;
  ULONG dwSequence;
  ULONG cbSizeData;
  UCHAR CommandData[4056];
} DXVA_COPPCommand, *LPDXVA_COPPCommand;

Membres

macKDI

Spécifie un GUID de code d’authentification de message (MAC) pour la commande dans CommandData. Le pilote d’affichage peut utiliser le MAC pour vérifier que la transmission de la commande a été sécurisée (autrement dit, elle n’a pas été falsifiée en transit vers le pilote).

guidCommandID

Spécifie le GUID qui identifie la commande. Les GUID suivants sont pris en charge :

DXVA_COPPSetProtectionLevel

Définit le type et le niveau de protection sur le connecteur physique associé à l’appareil COPP.

Le GUID DXVA_COPPSetProtectionLevel est défini comme suit :

DEFINE_GUID(DXVA_COPPSetProtectionLevel,
    0x9bb9327c,0x4eb5,0x4727,0x9f,0x00,0xb4,0x2b,0x09,0x19,0xc0,0xda);

DXVA_COPPSetSignaling

Instructions sur la façon de protéger le signal qui passe par le connecteur physique associé à l’appareil COPP Va DirectX.

Le GUID DXVA_COPPSetSignaling est défini comme suit :

DEFINE_GUID(DXVA_COPPSetSignaling,
    0x9a631a5,0xd684,0x4c60,0x8e,0x4d,0xd3,0xbb,0xf,0xb,0xe3,0xee);

dwSequence

Spécifie un numéro de séquence. Pour que la fonction COPPCommand traite la commande, la valeur dans dwSequence doit correspondre au numéro de séquence de départ aléatoire 32 bits status qui a été passé dans la structure DXVA_COPPSignature à la fonction COPPSequenceStart.

cbSizeData

Spécifie la taille, en octets, des données de commande dans CommandData.

CommandData[4056]

Spécifie un tableau qui comprend les données de commande.

Remarques

Pour une commande DXVA_COPPSetProtectionLevel, les informations de protection sont fournies dans les 16 premiers octets du tableau CommandData (le type de protection dans les 4 premiers octets, le niveau de protection dans les 4 octets suivants, et éventuellement certaines informations étendues dans les 8 derniers octets). Dans l’appel à la fonction COPPCommand , le tableau CommandData doit être converti en pointeur vers une structure DXVA_COPPSetProtectionLevelCmdData , qui contient le type de protection, le niveau de protection et les membres d’informations étendues.

Pour une commande DXVA_COPPSetSignaling, les informations de signalisation sont fournies en cas de conversion du tableau CommandData en pointeur vers une structure DXVA_COPPSetSignalingCmdData .

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)