DXVA_COPPStatusData Struktur (dxva.h)

Artikel
02/06/2025

Die DXVA_COPPStatusData Struktur enthält die Statusinformationen, die von einer Abfrage in einer geschützten Videositzung zurückgegeben werden, die einem DirectX VA COPP-Gerät zugeordnet ist.

Syntax

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

Angehörige

rApp

Gibt eine 128-Bit-Zufallszahl an, die einmal verwendet wird. Diese Zufallszahl wird von der anfordernden Anwendung generiert und dem Anzeigetreiber im rApp Member der DXVA_COPPStatusInput Struktur bereitgestellt.

dwFlags

Gibt zusätzliche Statusinformationen an, die für die aufrufende Anwendung relevant sein können. Der Anzeigetreiber sollte dwFlags- auf den COPP_StatusNormal -Wert (0x00) des COPP_StatusFlags Enumerationstyps oder auf eine gültige Kombination aus der folgenden COPP_StatusFlags festlegen:

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

Gibt 32-Bit-Statusdaten an, die von einer der folgenden Anforderungen zurückgegeben werden, die im pInput Parameter der COPPQueryStatus--Funktion übergeben werden.

DXVA_COPPQueryProtectionType

Gibt eine gültige ORed-Kombination der folgenden Werte zurück, die die verfügbaren Arten von Schutzmechanismen für den physischen Verbinder angeben, der einem COPP-Gerät zugeordnet ist:

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

DXVA_COPPQueryConnectorType

Gibt einen der folgenden Werte aus dem COPP_ConnectorType Enumerationstyp zurück, der den Typ des physischen Verbinders identifiziert, den die Videositzung verwendet:

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)

Der wert COPP_ConnectorType_Internal (0x80000000) wird nur mit einem der vorherigen Verbindungstypwerte kombiniert, um anzugeben, dass die Verbindung zwischen dem Grafikadapter und dem Anzeigemonitor dauerhaft ist und nicht von außerhalb eines nicht benutzerfreundlichen Gehäuses zugänglich ist.

DXVA_COPPQueryLocalProtectionLevel

Gibt die aktuell festgelegte Schutzebene für die Videositzung zurück. Der Wert auf Schutzebene hängt vom Schutztyp ab, der im StatusData- Mitglied der DXVA_COPPStatusInput-Struktur angegeben ist. Mögliche Schutzebenen finden Sie im ProtLevel Member der DXVA_COPPSetProtectionLevelCmdData-Struktur.

DXVA_COPPQueryGlobalProtectionLevel

Gibt die aktuell festgelegte Schutzebene für den physischen Verbinder zurück. Der zurückgegebene Levelwert muss die aktuell über den Verbinder angewendete Schutzebene widerspiegeln, unabhängig davon, wie der Treiber angewiesen wurde, die Schutzebene anzuwenden. Beispiel: Wenn ACP über die Win32-ChangeDisplaySettingsEx--Funktion und nicht über die IAMCertifiedOutputProtection-Schnittstelle aktiviert wurde, muss die globale Schutzebene, die über einen Aufruf der COPPQueryStatus--Funktion für den Connector zurückgegeben wurde, angeben, dass ACP aktiviert wurde, auch wenn ACP nicht über die IAMCertifiedOutputProtection Schnittstelle aktiviert wurde.

Der Wert auf Schutzebene hängt vom Schutztyp ab, der im StatusData- Mitglied der DXVA_COPPStatusInput-Struktur angegeben ist. Mögliche Schutzebenen finden Sie im ProtLevel Member der DXVA_COPPSetProtectionLevelCmdData-Struktur.

DXVA_COPPQueryBusData

Gibt einen der folgenden Werte aus dem COPP_BusType Enumerationstyp zurück, der den Typ des bus identifiziert, der von der Grafikhardware verwendet wird, die einem COPP-Gerät zugeordnet ist:

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

Der wert COPP_BusType_Integrated (0x80000000) kann nur mit einem der vorherigen Bustypwerte kombiniert werden, wenn keines der Befehls- und Statusschnittstellensignale zwischen dem Grafikkartenadapter und anderen Subsystemen in einem Erweiterungsbus verfügbar ist, der eine öffentlich verfügbare Spezifikation und einen Standardverbindertyp verwendet. Speicherbusse werden von dieser Definition ausgeschlossen.

ExtendedInfoValidMask

Gibt einen Wert an, der die gültigen Bitfelder im folgenden ExtendedInfoData Member angibt.

ExtendedInfoData

Gibt zusätzliche 32-Bit-Daten für den Status an. Zurzeit nicht verwendet.

Bemerkungen

Der Anzeigetreiber gibt Statusinformationen über den pOutput Parameter von COPPQueryStatuszurück. Die DXVA_COPPStatusOutput Struktur beschreibt die zurückgegebenen Statusinformationen. Der Anzeigetreiber sollte die Statusinformationen in einen Zeiger in eine DXVA_COPPStatusData Struktur umwandeln und die Statusinformationen im COPPStatus Mitglied von DXVA_COPPStatusOutput zurückgeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Diese Struktur gilt nur für Windows Server 2003 mit SP1 und höher und Windows XP mit SP2 und höher.
Header-	dxva.h (include Dxva.h)