Informazioni di riferimento sulla query COPP

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

In questa sezione vengono descritte le query di stato supportate dal protocollo COPP (Certified Output Protection Protocol). Per ogni query, il GUID che definisce la query è elencato, insieme ai dati di input e ai dati restituiti.

Query dati del bus

Restituisce il tipo di bus di I/O usato dalla scheda grafica.

• GUID: DXVA_COPPQueryBusData
• Dati di input: Nessuno.
• Restituisce i dati: restituisce una struttura DXVA_COPPStatusData . Il tipo di bus viene restituito nel membro dwData come flag dell'enumerazione COPP_BusType .

Query del tipo di connettore

Restituisce il tipo di connettore fisico.

• GUID: DXVA_COPPQueryConnectorType
• Dati di input: Nessuno.
• Restituisce i dati: restituisce una struttura DXVA_COPPStatusData . Il tipo di connettore viene restituito nel membro dwData come flag dall'enumerazione COPP_ConnectorType .

Visualizzare query dati

Restituisce una descrizione del segnale video trasmesso sul connettore.

Il segnale video trasmesso sul connettore non ha necessariamente lo stesso formato della modalità di visualizzazione desktop. Ad esempio, la modalità di visualizzazione desktop potrebbe essere di 1024x768 pixel a 85 Hz, mentre il connettore potrebbe essere un connettore S-Video che trasmette un segnale video a 720x480 pixel, 60/1.01 Hz interlacciato. In questo caso, il driver restituirà la risoluzione del segnale S-Video, non la risoluzione del desktop.

• GUID: DXVA_COPPQueryDisplayData
• Dati di input: Nessuno.
• Restituisce i dati: restituisce una struttura DXVA_COPPStatusDisplayData .

Query dati chiave HDCP

Restituisce il vettore di selezione della chiave HDCP del dispositivo (B-KSV).

KSV è un identificatore fornito al produttore del dispositivo e viene usato nel processo di autenticazione e configurazione HDCP. L'applicazione deve controllare questo valore rispetto all'elenco di KSV revocati. Il meccanismo per ottenere l'elenco di revoche KSV non rientra nell'ambito del protocollo COPP. Per altre informazioni, consultare la specifica HDCP.

Questa query determina anche se il dispositivo HDCP connesso è un monitor o un ripetitore HDCP. L'applicazione non deve riprodurre contenuto protetto se il dispositivo HDCP è un ripetitore HDCP, perché non sono supportati da COPP.

• GUID: DXVA_COPPQueryHDCPKeyData
• Dati di input: Nessuno.
• Restituisce i dati: restituisce una struttura di DXVA_COPPStatusHDCPKeyData .

Query a livello di protezione globale

Restituisce il livello di protezione globale per un meccanismo di protezione specificato.

Il livello di protezione globale è il livello di protezione attualmente applicato sul connettore, indipendentemente dal modo in cui il driver grafico è stato incaricato di applicare la protezione. Ad esempio, un'applicazione può impostare il livello di protezione ACP chiamando la funzione ChangeDisplaySettingsEx . In tal caso, il livello di protezione globale rifletterebbe questa impostazione, anche se non è stata richiesta tramite COPP.

• GUID: DXVA_COPPQueryGlobalProtectionLevel

• Dati di input: meccanismo di protezione da eseguire query, specificato come intero a 32 bit. Vedere Flag di tipo di protezione COPP.

• Restituisce i dati: restituisce una struttura DXVA_COPPStatusData . Il livello di protezione corrente viene restituito nel membro dwData . Il significato di questo valore dipende dal meccanismo di protezione sottoposto a query. Per ogni meccanismo di protezione, il valore del membro dwData è un flag da un'enumerazione diversa, come illustrato nella tabella seguente.

  Meccanismo di protezione	Enumerazione
  ACP	COPP_ACP_Protection_Level
  CGMS-A	COPP_CGMSA_Protection_Level
  HDCP	COPP_HDCP_Protection_Level

   

Query a livello di protezione locale

Restituisce il livello di protezione locale per un meccanismo di protezione specificato.

Il livello di protezione locale è il livello di protezione richiesto tramite la sessione COPP corrente. Il driver potrebbe impostare un livello di protezione superiore.

• GUID: DXVA_COPPQueryLocalProtectionLevel

• Dati di input: meccanismo di protezione da eseguire in query come intero a 32 bit. Vedere Flag di tipo di protezione COPP.

• Restituisce i dati: restituisce una struttura DXVA_COPPStatusData . Il livello di protezione corrente viene restituito nel membro dwData . Il significato di questo valore dipende dal meccanismo di protezione sottoposto a query. Per ogni meccanismo di protezione, il valore del membro dwData è un flag da un'enumerazione diversa, come illustrato nella tabella seguente.

  Meccanismo di protezione	Enumerazione
  ACP	COPP_ACP_Protection_Level
  CGMS-A	COPP_CGMSA_Protection_Level
  HDCP	COPP_HDCP_Protection_Level

   

Query tipo di protezione

Restituisce i meccanismi di protezione disponibili per il connettore.

• GUID: DXVA_COPPQueryProtectionType
• Dati di input: Nessuno.
• Restituisce i dati: restituisce una struttura DXVA_COPPStatusData . I meccanismi di protezione vengono restituiti nel membro dwData come combinazione di zero o più flag. Vedere Flag di tipo di protezione COPP. Se sono disponibili più meccanismi di protezione, i flag vengono combinati con un OR bit per bit.

Query di segnalazione

Restituisce un elenco di tutti gli standard di protezione supportati dal driver, lo standard attualmente attivo e il rapporto di aspetto corrente o altri dati di segnalazione.

• GUID: DXVA_COPPQuerySignaling
• Dati di input: Nessuno.
• Restituisce i dati: restituisce una struttura DXVA_COPPStatusSignalingCmdData .

Argomenti correlati

Uso del protocollo COPP (Certified Output Protection Protocol)