DXVA_COPPCommand-Struktur (dxva.h)

Artikel
02/29/2024

Die DXVA_COPPCommand-Struktur beschreibt einen Befehl, der an eine geschützte Videositzung gesendet wird, die einem COPP DirectX VA-Gerät zugeordnet ist.

Syntax

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

Member

macKDI

Gibt eine MAC-GUID (Message Authentication Code) für den Befehl unter CommandData an. Der Anzeigetreiber kann den MAC verwenden, um zu überprüfen, ob die Übertragung des Befehls sicher war (das heißt, er wurde bei der Übertragung an den Treiber nicht manipuliert).

guidCommandID

Gibt die GUID an, die den Befehl identifiziert. Die folgenden GUIDs werden unterstützt:

DXVA_COPPSetProtectionLevel

Legt den Schutztyp und die Ebene für den physischen Connector fest, der dem COPP-Gerät zugeordnet ist.

Die DXVA_COPPSetProtectionLevel GUID ist wie folgt definiert:

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

DXVA_COPPSetSignaling

Eine Anleitung zum Schützen des Signals, das über den physischen Anschluss geht, der dem DirectX VA COPP-Gerät zugeordnet ist.

Die DXVA_COPPSetSignaling GUID ist wie folgt definiert:

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

dwSequence

Gibt eine Sequenznummer an. Damit die COPPCommand-Funktion den Befehl verarbeiten kann, muss der Wert in dwSequence mit der zufälligen 32-Bit-Startnummer status Sequenznummer übereinstimmen, die in der DXVA_COPPSignature-Struktur an die COPPSequenceStart-Funktion übergeben wurde.

cbSizeData

Gibt die Größe der Befehlsdaten unter CommandData in Bytes an.

CommandData[4056]

Gibt ein Array an, das die Befehlsdaten enthält.

Hinweise

Für einen DXVA_COPPSetProtectionLevel-Befehl werden die Schutzinformationen in den ersten 16 Bytes des CommandData-Arrays angegeben (der Schutztyp in den ersten 4 Bytes, die Schutzebene in den nächsten 4 Bytes und möglicherweise einige erweiterte Informationen in den letzten 8 Bytes). Beim Aufruf der COPPCommand-Funktion sollte das CommandData-Array in einen Zeiger auf eine DXVA_COPPSetProtectionLevelCmdData-Struktur umgewandelt werden, die Schutztyp, Schutzebene und erweiterte Informationsmember enthält.

Für einen DXVA_COPPSetSignaling-Befehl werden die Signalinformationen bereitgestellt, indem das CommandData-Array in einen Zeiger auf eine DXVA_COPPSetSignalingCmdData-Struktur umgestellt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Diese Struktur gilt nur für Windows Server 2003 mit SP1 und höher und Windows XP mit SP2 und höher.
Kopfzeile	dxva.h (einschließlich Dxva.h)