DXVA_COPPStatusData struttura (dxva.h)

Articolo
03/08/2023

La struttura DXVA_COPPStatusData contiene le informazioni sullo stato restituite da una query in una sessione video protetta associata a un dispositivo DirectX VA COPP.

Sintassi

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

Members

rApp

Specifica un numero casuale a 128 bit usato una volta. Questo numero casuale viene generato dall'applicazione di richiesta e fornito al driver di visualizzazione nel membro rApp della struttura DXVA_COPPStatusInput .

dwFlags

Specifica informazioni di stato aggiuntive che potrebbero essere rilevanti per l'applicazione chiamante. Il driver di visualizzazione deve impostare dwFlags sul valore COPP_StatusNormal (0x00) dal tipo di enumerazione COPP_StatusFlags o su una combinazione ORed valida della COPP_StatusFlags seguente:

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

Specifica i dati di stato a 32 bit restituiti da una delle richieste seguenti passate nel parametro pInput della funzione COPPQueryStatus .

DXVA_COPPQueryProtectionType

Restituisce una combinazione ORed valida dei valori seguenti che indicano i tipi disponibili di meccanismi di protezione nel connettore fisico associato a un dispositivo COPP:

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

DXVA_COPPQueryConnectorType

Restituisce uno dei valori seguenti dal tipo di enumerazione COPP_ConnectorType che identifica il tipo di connettore fisico usato dalla sessione video:

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)

Il valore COPP_ConnectorType_Internal (0x80000000) viene combinato solo con uno dei valori di tipo connettore precedenti per indicare che la connessione tra la scheda grafica e il monitor di visualizzazione è permanente e non accessibile dall'esterno di un'istanza non utilizzabile dall'utente.

DXVA_COPPQueryLocalProtectionLevel

Restituisce il livello di protezione attualmente impostato per la sessione video. Il valore a livello di protezione dipende dal tipo di protezione specificato nel membro StatusData della struttura DXVA_COPPStatusInput . Per i possibili livelli di protezione, vedere il membro ProtLevel della struttura DXVA_COPPSetProtectionLevelCmdData .

DXVA_COPPQueryGlobalProtectionLevel

Restituisce il livello di protezione attualmente impostato per il connettore fisico. Il valore del livello restituito deve riflettere il livello di protezione attualmente applicato tramite il connettore, indipendentemente dal modo in cui il driver è stato incaricato di applicare il livello di protezione. Ad esempio, se ACP è stato abilitato tramite la funzione Win32 ChangeDisplaySettingsEx e non tramite l'interfaccia IAMCertifiedOutputProtection , il livello di protezione globale restituito tramite una chiamata alla funzione COPPQueryStatus per il connettore deve indicare che ACP è stato abilitato, anche se ACP non è stato abilitato tramite l'interfaccia IAMCertifiedOutputProtection .

Il valore a livello di protezione dipende dal tipo di protezione specificato nel membro StatusData della struttura DXVA_COPPStatusInput . Per i possibili livelli di protezione, vedere il membro ProtLevel della struttura DXVA_COPPSetProtectionLevelCmdData .

DXVA_COPPQueryBusData

Restituisce uno dei valori seguenti dal tipo di enumerazione COPP_BusType che identifica il tipo di bus usato dall'hardware grafico associato a un dispositivo COPP:

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

Il valore COPP_BusType_Integrated (0x80000000) può essere combinato solo con uno dei valori del tipo di bus precedente quando nessuno dei segnali dell'interfaccia di comando e stato tra la scheda grafica e altri sottosistemi è disponibile in un bus di espansione che usa una specifica disponibile pubblicamente e un tipo di connettore standard. Gli autobus di memoria vengono esclusi da questa definizione.

ExtendedInfoValidMask

Specifica un valore che indica i campi di bit validi nel membro ExtendedInfoData seguente.

ExtendedInfoData

Specifica altri dati a 32 bit per lo stato. Attualmente non utilizzato.

Commenti

Il driver di visualizzazione restituisce informazioni sullo stato tramite il parametro pOutput di COPPQueryStatus. La struttura DXVA_COPPStatusOutput descrive le informazioni sullo stato restituite. Il driver di visualizzazione deve eseguire il cast delle informazioni sullo stato in un puntatore a una struttura DXVA_COPPStatusData e restituire le informazioni sullo stato nel membro COPPStatus di DXVA_COPPStatusOutput.

Requisiti

Requisito	Valore
Client minimo supportato	Questa struttura si applica solo a Windows Server 2003 con SP1 e versioni successive e Windows XP con SP2 e versioni successive.
Intestazione	dxva.h (include Dxva.h)