DXVA_COPPStatusData-Struktur (dxva.h)

Artikel
02/26/2024

Die DXVA_COPPStatusData-Struktur enthält die status Informationen, die von einer Abfrage für eine geschützte 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;

Member

rApp

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

dwFlags

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

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

Gibt 32-Bit-status Daten 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 Connector 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 Connectors 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 COPP_ConnectorType_Internal -Wert (0x80000000) wird nur mit einem der vorherigen Werte des Connectortyps kombiniert, um anzugeben, dass die Verbindung zwischen dem Grafikkarte und dem Anzeigemonitor dauerhaft ist und nicht von außen in einem nicht vom Benutzer zu verwendenden Gehäuse 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-Member der DXVA_COPPStatusInput-Struktur angegeben ist. Mögliche Schutzstufen finden Sie im ProtLevel-Element der DXVA_COPPSetProtectionLevelCmdData-Struktur .

DXVA_COPPQueryGlobalProtectionLevel

Gibt die derzeit festgelegte Schutzstufe für den physischen Connector zurück. Der zurückgegebene Levelwert muss die schutzebene widerspiegeln, die derzeit über den Connector angewendet wird, unabhängig davon, wie der Treiber angewiesen wurde, die Schutzstufe anzuwenden. Wenn ACP beispielsweise über die Win32 ChangeDisplaySettingsEx-Funktion und nicht über die IAMCertifiedOutputProtection-Schnittstelle aktiviert wurde, muss die globale Schutzebene, die durch einen Aufruf der COPPQueryStatus-Funktion für den Connector zurückgegeben wurde, angeben, dass ACP aktiviert wurde, obwohl ACP nicht über die IAMCertifiedOutputProtection-Schnittstelle aktiviert wurde.

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

DXVA_COPPQueryBusData

Gibt einen der folgenden Werte aus dem COPP_BusType Enumerationstyp zurück, der den Typ des Busses angibt, 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 status Schnittstellensignale zwischen dem Grafikkarte und anderen Subsystemen auf einem Erweiterungsbus verfügbar ist, der eine öffentlich verfügbare Spezifikation und einen Standardsteckertyp verwendet. Speicherbusse sind 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 die status an. Derzeit nicht verwendet.

Hinweise

Der Anzeigetreiber gibt status Informationen über den pOutput-Parameter von COPPQueryStatus zurück. Die DXVA_COPPStatusOutput-Struktur beschreibt die zurückgegebenen status Informationen. Der Anzeigetreiber sollte die status Informationen in einen Zeiger auf eine DXVA_COPPStatusData-Struktur umwandeln und die status Informationen im COPPStatus-Member von DXVA_COPPStatusOutput zurückgeben.

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)