estrutura DXVA_COPPStatusData (dxva.h)

Artigo
03/01/2024

A estrutura DXVA_COPPStatusData contém as informações de status retornadas de uma consulta em uma sessão de vídeo protegida associada a um dispositivo COPP do DirectX VA.

Sintaxe

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

Membros

rApp

Especifica um número aleatório de 128 bits que é usado uma vez. Esse número aleatório é gerado pelo aplicativo solicitante e fornecido ao driver de exibição no membro rApp da estrutura DXVA_COPPStatusInput .

dwFlags

Especifica informações adicionais de status que podem ser relevantes para o aplicativo de chamada. O driver de exibição deve definir dwFlags como o valor COPP_StatusNormal (0x00) do tipo de enumeração COPP_StatusFlags ou como uma combinação ORed válida dos seguintes COPP_StatusFlags:

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

Especifica dados de status de 32 bits retornados de uma das solicitações a seguir passadas no parâmetro pInput da função COPPQueryStatus.

DXVA_COPPQueryProtectionType

Retorna uma combinação ORed válida dos seguintes valores que indicam os tipos disponíveis de mecanismos de proteção no conector físico associado a um dispositivo COPP:

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

DXVA_COPPQueryConnectorType

Retorna um dos seguintes valores do tipo de enumeração COPP_ConnectorType que identifica o tipo de conector físico que a sessão de vídeo usa:

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)

O valor de COPP_ConnectorType_Internal (0x80000000) é combinado apenas com um dos valores anteriores do tipo conector para indicar que a conexão entre o adaptador gráfico e o monitor de exibição é permanente e não acessível de fora de um compartimento não acessível pelo usuário.

DXVA_COPPQueryLocalProtectionLevel

Retorna o nível de proteção definido no momento para a sessão de vídeo. O valor no nível de proteção depende do tipo de proteção especificado no membro StatusData da estrutura DXVA_COPPStatusInput . Para obter possíveis níveis de proteção, consulte o membro ProtLevel da estrutura DXVA_COPPSetProtectionLevelCmdData .

DXVA_COPPQueryGlobalProtectionLevel

Retorna o nível de proteção definido no momento para o conector físico. O valor de nível retornado deve refletir o nível de proteção atualmente aplicado por meio do conector, independentemente de como o driver foi instruído a aplicar o nível de proteção. Por exemplo, se a ACP foi habilitada por meio da função Win32 ChangeDisplaySettingsEx e não por meio da interface IAMCertifiedOutputProtection , o nível de proteção global retornado por meio de uma chamada para a função COPPQueryStatus para o conector deve indicar que a ACP foi habilitada, mesmo que a ACP não tenha sido habilitada por meio da interface IAMCertifiedOutputProtection .

O valor no nível de proteção depende do tipo de proteção especificado no membro StatusData da estrutura DXVA_COPPStatusInput . Para obter possíveis níveis de proteção, consulte o membro ProtLevel da estrutura DXVA_COPPSetProtectionLevelCmdData .

DXVA_COPPQueryBusData

Retorna um dos seguintes valores do tipo de enumeração COPP_BusType que identifica o tipo de barramento usado pelo hardware gráfico associado a um dispositivo COPP:

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

O valor de COPP_BusType_Integrated (0x80000000) só pode ser combinado com um dos valores anteriores do tipo barramento quando nenhum dos sinais de interface de comando e status entre o adaptador gráfico e outros subsistemas estiverem disponíveis em um barramento de expansão que usa uma especificação disponível publicamente e um tipo de conector padrão. Os barramentos de memória são excluídos dessa definição.

ExtendedInfoValidMask

Especifica um valor que indica os campos de bit válidos no membro ExtendedInfoData a seguir.

ExtendedInfoData

Especifica dados adicionais de 32 bits para o status. Não usado no momento.

Comentários

O driver de exibição retorna status informações por meio do parâmetro pOutput de COPPQueryStatus. A estrutura DXVA_COPPStatusOutput descreve as informações de status retornadas. O driver de exibição deve converter as informações de status em um ponteiro para uma estrutura DXVA_COPPStatusData e retornar as informações de status no membro COPPStatus do DXVA_COPPStatusOutput.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Essa estrutura se aplica somente ao Windows Server 2003 com SP1 e posterior e ao Windows XP com SP2 e posterior.
Cabeçalho	dxva.h (inclua Dxva.h)