DXVA_COPPStatusInput structure (dxva.h)

Article
02/26/2024

La structure DXVA_COPPStatusInput décrit une demande de status sur une session vidéo protégée associée à un appareil DirectX VA COPP.

Syntaxe

typedef struct _DXVA_COPPStatusInput {
  GUID  rApp;
  GUID  guidStatusRequestID;
  ULONG dwSequence;
  ULONG cbSizeData;
  UCHAR StatusData[4056];
} DXVA_COPPStatusInput, *LPDXVA_COPPStatusInput;

Membres

rApp

Spécifie un nombre aléatoire 128 bits (utilisé une fois) généré par l’application d’envoi. Ce nombre aléatoire est également retourné par le pilote d’affichage avec les données status dans le membre rApp de la structure DXVA_COPPStatusData. Le pilote d’affichage fournit également ce nombre aléatoire au générateur de code d’authentification de message (MAC) pour générer le GUID MAC.

guidStatusRequestID

Spécifie le GUID qui identifie la demande status. Les GUID de requête status suivants sont pris en charge :

DXVA_COPPQueryConnectorType

DEFINE_GUID(DXVA_COPPQueryConnectorType,
  0x81d0bfd5,0x6afe,0x48c2,0x99,0xc0,0x95,0xa0,0x8f,0x97,0xc5,0xda);

DXVA_COPPQueryProtectionType

DEFINE_GUID(DXVA_COPPQueryProtectionType,
  0x38f2a801,0x9a6c,0x48bb,0x91,0x07,0xb6,0x69,0x6e,0x6f,0x17,0x97);

DXVA_COPPQueryLocalProtectionLevel

DEFINE_GUID(DXVA_COPPQueryLocalProtectionLevel,
  0xb2075857,0x3eda,0x4d5d,0x88,0xdb,0x74,0x8f,0x8c,0x1a,0x05,0x49);

DXVA_COPPQueryGlobalProtectionLevel

DEFINE_GUID(DXVA_COPPQueryGlobalProtectionLevel,
  0x1957210a,0x7766,0x452a,0xb9,0x9a,0xd2,0x7a,0xed,0x54,0xf0,0x3a);

DXVA_COPPQueryDisplayData

DEFINE_GUID(DXVA_COPPQueryDisplayData,
  0xd7bf1ba3,0xad13,0x4f8e,0xaf,0x98,0x0d,0xcb,0x3c,0xa2,0x04,0xcc);

DXVA_COPPQueryHDCPKeyData

DEFINE_GUID(DXVA_COPPQueryHDCPKeyData,
  0xdb59d74,0xa992,0x492e,0xa0,0xbd,0xc2,0x3f,0xda,0x56,0x4e,0x0);

DXVA_COPPQueryBusData

DEFINE_GUID(DXVA_COPPQueryBusData,
  0xc6f4d673,0x6174,0x4184,0x8e,0x35,0xf6,0xdb,0x52, 0x0,0xbc,0xba);

DXVA_COPPQuerySignaling

DEFINE_GUID(DXVA_COPPQuerySignaling,
  0x6629a591,0x3b79,0x4cf3,0x92,0x4a,0x11,0xe8,0xe7,0x81,0x16,0x71);

dwSequence

Spécifie un numéro de séquence. Pour que la fonction COPPQueryStatus traite la requête status, 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 requête status dans StatusData.

StatusData[4056]

Spécifie un tableau qui contient les données qui accompagnent la demande de status identifiée par guidStatusRequestID.

Aucune donnée n’est requise pour les requêtes DXVA_COPPQueryConnectorType, DXVA_COPPQueryProtectionType, DXVA_COPPQueryDisplayData, DXVA_COPPQueryHDCPKeyData, DXVA_COPPQueryBusData et DXVA_COPPQuerySignaling.

Les demandes DXVA_COPPQueryLocalProtectionLevel et DXVA_COPPQueryGlobalProtectionLevel nécessitent des données qui identifient le type de protection pour lequel le niveau de protection est demandé. Par conséquent, ces demandes nécessitent que les 4 premiers octets du tableau StatusData contiennent le type de protection.

Remarques

Les demandes d’état sont passées dans le paramètre pInput de la fonction COPPQueryStatus . Les informations d’état sont retournées via le paramètre pOutput de COPPQueryStatus. La structure DXVA_COPPStatusOutput décrit les informations de status retournées.

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)