COPP-Abfragereferenz
In diesem Abschnitt werden die Statusabfragen 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 |
Busdatenabfrage
Gibt den Typ des E/A-Bus zurück, der vom Grafikadapter verwendet wird.
- GUID: DXVA _ COPPQueryBusData
- Eingabedaten: Keine.
- Rückgabedaten: Gibt eine _ DXVA-COPPStatusData-Struktur zurück. Der Bustyp wird im dwData-Member als Flag von der COPP _ BusType-Enumeration zurückgegeben.
Connectortypabfrage
Gibt den physischen Connectortyp zurück.
- GUID: DXVA _ COPPQueryConnectorType
- Eingabedaten: Keine.
- Rückgabedaten: Gibt eine _ DXVA-COPPStatusData-Struktur zurück. Der Connectortyp wird im dwData-Member als Flag von der COPP _ ConnectorType-Enumeration zurückgegeben.
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 beispielsweise 1024 x 768 Pixel bei 85 Hz betragen, während der Connector ein S-Video-Connector sein kann, der ein Videosignal mit 720 x 480 Pixeln und 60/1,01 Hz-Interlacing überträgt. In diesem Fall gibt der Treiber die Auflösung des S-Video-Signals zurück, nicht die Desktopauflösung.
- GUID: DXVA _ COPPQueryDisplayData
- Eingabedaten: Keine.
- Rückgabedaten: Gibt eine DXVA _ COPPStatusDisplayData-Struktur zurück.
HDCP-Schlüsseldatenabfrage
Gibt den HDCP-Schlüsselauswahlvektor (B-KSV) des Geräts zurück.
Die KSV ist ein Bezeichner, der dem Gerätehersteller bereitgestellt wird und bei der HDCP-Authentifizierung und -Einrichtung verwendet wird. Die Anwendung sollte diesen Wert mit der Liste der gesperrten 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 keine geschützten Inhalte wieder geben, wenn das HDCP-Gerät ein HDCP-Repeater ist, da diese von COPP nicht unterstützt werden.
- GUID: DXVA _ COPPQueryHDCPKeyData
- Eingabedaten: Keine.
- Rückgabedaten: Gibt eine _ DXVA-STRUKTUR COPPStatusHDCPKeyData zurück.
Abfrage auf globaler 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 zu abfragende Schutzmechanismus, angegeben als 32-Bit-Ganzzahl. Weitere Informationen finden Sie unter COPP-Schutztypflags.
Rückgabedaten: 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-Mitglieds ein Flag aus einer anderen Enumeration, wie in der folgenden Tabelle gezeigt.
Schutzmechanismus Enumeration ACP COPP _ _ _ ACP-Schutzebene CGMS-A _COPP-CGMSA-Schutzebene _ _ HDCP COPP _ _ HDCP-Schutzebene _
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 abfragte Schutzmechanismus als 32-Bit-Ganzzahl. Weitere Informationen finden Sie unter COPP-Schutztypflags.
Rückgabedaten: 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-Mitglieds ein Flag aus einer anderen Enumeration, wie in der folgenden Tabelle gezeigt.
Schutzmechanismus Enumeration ACP COPP _ _ _ ACP-Schutzebene CGMS-A _COPP-CGMSA-Schutzebene _ _ HDCP COPP _ _ HDCP-Schutzebene _
Schutztypabfrage
Gibt die Schutzmechanismen zurück, die für den Connector verfügbar sind.
- GUID: DXVA _ COPPQueryProtectionType
- Eingabedaten: Keine.
- Rückgabedaten: Gibt eine _ DXVA-COPPStatusData-Struktur zurück. Die Schutzmechanismen werden im dwData-Element als Kombination aus 0 (null) oder mehr Flags zurückgegeben. Weitere Informationen finden Sie unter COPP-Schutztypflags. Wenn mehr als ein Schutzmechanismus verfügbar ist, werden die Flags mit einem bitweisen OR kombiniert.
Signalisierungsabfrage
Gibt eine Liste aller Schutzstandards zurück, die vom Treiber unterstützt werden, den derzeit aktiven Standard und das aktuelle Seitenverhältnis oder andere Signaldaten.
- GUID: DXVA _ COPPQuerySignaling
- Eingabedaten: Keine.
- Daten zurückgeben: Gibt eine _ DXVA-COPPStatusSignalingCmdData-Struktur zurück.