COPP-Abfragereferenz

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

In diesem Abschnitt werden die status Abfragen beschrieben, die vom Certified Output Protection Protocol (COPP) unterstützt werden. Für jede Abfrage wird die GUID, die die Abfrage definiert, zusammen mit den Eingabe- und Rückgabedaten aufgeführt.

Abfrage GUID
Busdaten DXVA_COPPQueryBusData
Connectortyp DXVA_COPPQueryConnectorType
Anzeigen von Daten DXVA_COPPQueryDisplayData
HDCP-Schlüsseldaten DXVA_COPPQueryHDCPKeyData
Globale Schutzebene DXVA_COPPQueryGlobalProtectionLevel
Lokale Schutzebene DXVA_COPPQueryLocalProtectionLevel
Schutztyp DXVA_COPPQueryProtectionType
Signaling DXVA_COPPQuerySignaling

 

Bus-Datenabfrage

Gibt den Typ des E/A-Busses zurück, der von der Grafikkarte verwendet wird.

Connectortypabfrage

Gibt den physischen Connectortyp zurück.

Datenabfrage anzeigen

Gibt eine Beschreibung des Videosignals zurück, das über den Connector übertragen wird.

Das Videosignal, das über den Connector übertragen wird, hat nicht unbedingt das gleiche Format wie der Desktopanzeigemodus. Der Desktopanzeigemodus kann z. B. 1024 x 768 Pixel bei 85 Hz betragen, während der Stecker ein S-Video-Connector sein kann, der ein Videosignal mit 720 x 480 Pixeln und 60/1,01 Hz interlaced überträgt. In diesem Fall gibt der Treiber die Auflösung des S-Video-Signals zurück, nicht die Desktopauflösung.

HDCP-Schlüsseldatenabfrage

Gibt den HDCP-Schlüsselauswahlvektor (B-KSV) des Geräts zurück.

Die KSV ist ein Bezeichner, der dem Gerätehersteller zur Verfügung gestellt wird und im HDCP-Authentifizierungs- und -Setupprozess verwendet wird. Die Anwendung sollte diesen Wert anhand der Liste der widerrufenen KSVs überprüfen. Der Mechanismus zum Abrufen der KSV-Sperrliste liegt außerhalb des Bereichs des COPP-Protokolls. Weitere Informationen finden Sie in der HDCP-Spezifikation.

Diese Abfrage bestimmt auch, ob das verbundene HDCP-Gerät ein Monitor oder ein HDCP-Repeater ist. Die Anwendung sollte geschützte Inhalte nicht wiedergeben, wenn das HDCP-Gerät ein HDCP-Repeater ist, da diese von COPP nicht unterstützt werden.

Abfrage der globalen Schutzebene

Gibt die globale Schutzebene für einen angegebenen Schutzmechanismus zurück.

Die globale Schutzebene ist die Schutzebene, die derzeit auf den Connector angewendet wird, unabhängig davon, wie der Grafiktreiber angewiesen wurde, den Schutz anzuwenden. Beispielsweise kann eine Anwendung die ACP-Schutzebene festlegen, indem sie die ChangeDisplaySettingsEx-Funktion aufruft . In diesem Fall würde die globale Schutzebene diese Einstellung widerspiegeln, obwohl sie nicht über COPP angefordert wurde.

  • GUID: DXVA_COPPQueryGlobalProtectionLevel

  • Eingabedaten: Der Schutzmechanismus, der als 32-Bit-Ganzzahl angegeben wird. Weitere Informationen finden Sie unter COPP-Schutztypflags.

  • Zurückgeben von Daten: Gibt eine DXVA_COPPStatusData-Struktur zurück. Die aktuelle Schutzebene wird im dwData-Element zurückgegeben. Die Bedeutung dieses Werts hängt vom abgefragten Schutzmechanismus ab. Für jeden Schutzmechanismus ist der Wert des dwData-Elements ein Flag aus einer anderen Enumeration, wie in der folgenden Tabelle gezeigt.

    Schutzmechanismus Enumeration
    ACP COPP_ACP_Protection_Level
    CGMS-A COPP_CGMSA_Protection_Level
    HDCP COPP_HDCP_Protection_Level

     

Abfrage auf lokaler Schutzebene

Gibt die lokale Schutzebene für einen angegebenen Schutzmechanismus zurück.

Die lokale Schutzebene ist die Schutzebene, die über die aktuelle COPP-Sitzung angefordert wurde. Der Treiber kann eine höhere Schutzebene festlegen.

  • GUID: DXVA_COPPQueryLocalProtectionLevel

  • Eingabedaten: Der Schutzmechanismus, der als 32-Bit-Ganzzahl abfragt werden soll. Weitere Informationen finden Sie unter COPP-Schutztypflags.

  • Zurückgeben von Daten: Gibt eine DXVA_COPPStatusData-Struktur zurück. Die aktuelle Schutzebene wird im dwData-Element zurückgegeben. Die Bedeutung dieses Werts hängt vom abgefragten Schutzmechanismus ab. Für jeden Schutzmechanismus ist der Wert des dwData-Elements ein Flag aus einer anderen Enumeration, wie in der folgenden Tabelle gezeigt.

    Schutzmechanismus Enumeration
    ACP COPP_ACP_Protection_Level
    CGMS-A COPP_CGMSA_Protection_Level
    HDCP COPP_HDCP_Protection_Level

     

Schutztypabfrage

Gibt die Schutzmechanismen zurück, die für den Connector verfügbar sind.

  • GUID: DXVA_COPPQueryProtectionType
  • Eingabedaten: Keine.
  • Zurückgeben von Daten: Gibt eine DXVA_COPPStatusData-Struktur zurück. Die Schutzmechanismen werden im dwData-Element als Kombination aus null oder mehr Flags zurückgegeben. Weitere Informationen finden Sie unter COPP-Schutztypflags. Wenn mehrere Schutzmechanismen verfügbar sind, werden die Flags mit einem bitweisen OR kombiniert.

Signaling Query

Gibt eine Liste aller Schutzstandards zurück, die vom Treiber unterstützt werden, den aktuell aktiven Standard und das aktuelle Seitenverhältnis oder andere Signalisierungsdaten.

Verwenden des Certified Output Protection Protocol (COPP)