Referência de consulta COPP
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
Esta seção descreve as consultas status compatíveis com o COPP (Certified Output Protection Protocol). Para cada consulta, o GUID que define a consulta é listado, juntamente com os dados de entrada e os dados de retorno.
Consulta | GUID |
---|---|
Dados do Barramento | DXVA_COPPQueryBusData |
Tipo de Conector | DXVA_COPPQueryConnectorType |
Exibir Dados | DXVA_COPPQueryDisplayData |
Dados de chave HDCP | DXVA_COPPQueryHDCPKeyData |
Nível de proteção global | DXVA_COPPQueryGlobalProtectionLevel |
Nível de proteção local | DXVA_COPPQueryLocalProtectionLevel |
Tipo de proteção | DXVA_COPPQueryProtectionType |
Sinalização | DXVA_COPPQuerySignaling |
Consulta de dados do barramento
Retorna o tipo de barramento de E/S usado pelo adaptador gráfico.
- GUID: DXVA_COPPQueryBusData
- Dados de entrada: nenhum.
- Retornar dados: retorna uma estrutura DXVA_COPPStatusData . O tipo de barramento é retornado no membro dwData como um sinalizador da enumeração COPP_BusType .
Consulta de tipo de conector
Retorna o tipo de conector físico.
- GUID: DXVA_COPPQueryConnectorType
- Dados de entrada: nenhum.
- Retornar dados: retorna uma estrutura DXVA_COPPStatusData . O tipo de conector é retornado no membro dwData como um sinalizador da enumeração COPP_ConnectorType .
Exibir Consulta de Dados
Retorna uma descrição do sinal de vídeo que está sendo transmitido pelo conector.
O sinal de vídeo transmitido pelo conector não tem necessariamente o mesmo formato que o modo de exibição da área de trabalho. Por exemplo, o modo de exibição da área de trabalho pode ter 1024 x 768 pixels a 85 Hz, enquanto o conector pode ser um conector S-Video que transmite um sinal de vídeo a 720 x 480 pixels, 60/1,01 Hz entrelaçado. Nesse caso, o driver retornaria a resolução do sinal S-Video, não a resolução da área de trabalho.
- GUID: DXVA_COPPQueryDisplayData
- Dados de entrada: nenhum.
- Retornar dados: retorna uma estrutura DXVA_COPPStatusDisplayData .
Consulta de dados de chave HDCP
Retorna o vetor de seleção de chave HDCP do dispositivo (B-KSV).
O KSV é um identificador fornecido ao fabricante do dispositivo e é usado no processo de autenticação e instalação do HDCP. O aplicativo deve marcar esse valor em relação à lista de KSVs revogados. O mecanismo para obter a lista de revogação KSV está fora do escopo do protocolo COPP. Para obter mais informações, consulte a especificação do HDCP.
Essa consulta também determina se o dispositivo HDCP conectado é um monitor ou um repetidor HDCP. O aplicativo não deverá reproduzir conteúdo protegido se o dispositivo HDCP for um repetidor HDCP, pois eles não têm suporte do COPP.
- GUID: DXVA_COPPQueryHDCPKeyData
- Dados de entrada: nenhum.
- Retornar dados: retorna uma estrutura DXVA_COPPStatusHDCPKeyData .
Consulta de nível de proteção global
Retorna o nível de proteção global para um mecanismo de proteção especificado.
O nível de proteção global é o nível de proteção que está sendo aplicado no conector, independentemente de como o driver gráfico foi instruído a aplicar a proteção. Por exemplo, um aplicativo pode definir o nível de proteção ACP chamando a função ChangeDisplaySettingsEx . Nesse caso, o nível de proteção global refletiria essa configuração, mesmo que não tenha sido solicitada por meio do COPP.
GUID: DXVA_COPPQueryGlobalProtectionLevel
Dados de entrada: o mecanismo de proteção a ser consultado, especificado como um inteiro de 32 bits. Confira Sinalizadores de tipo de proteção COPP.
Retornar dados: retorna uma estrutura DXVA_COPPStatusData . O nível de proteção atual é retornado no membro dwData . O significado desse valor depende do mecanismo de proteção consultado. Para cada mecanismo de proteção, o valor do membro dwData é um sinalizador de uma enumeração diferente, conforme mostrado na tabela a seguir.
Mecanismo de proteção Enumeração ACP COPP_ACP_Protection_Level CGMS-A COPP_CGMSA_Protection_Level HDCP COPP_HDCP_Protection_Level
Consulta em nível de proteção local
Retorna o nível de proteção local para um mecanismo de proteção especificado.
O nível de proteção local é o nível de proteção solicitado por meio da sessão COPP atual. O driver pode definir um nível de proteção mais alto.
GUID: DXVA_COPPQueryLocalProtectionLevel
Dados de entrada: o mecanismo de proteção a ser consultado, como um inteiro de 32 bits. Confira Sinalizadores de tipo de proteção COPP.
Retornar dados: retorna uma estrutura DXVA_COPPStatusData . O nível de proteção atual é retornado no membro dwData . O significado desse valor depende do mecanismo de proteção consultado. Para cada mecanismo de proteção, o valor do membro dwData é um sinalizador de uma enumeração diferente, conforme mostrado na tabela a seguir.
Mecanismo de proteção Enumeração ACP COPP_ACP_Protection_Level CGMS-A COPP_CGMSA_Protection_Level HDCP COPP_HDCP_Protection_Level
Consulta de tipo de proteção
Retorna os mecanismos de proteção disponíveis para o conector.
- GUID: DXVA_COPPQueryProtectionType
- Dados de entrada: nenhum.
- Retornar dados: retorna uma estrutura DXVA_COPPStatusData . Os mecanismos de proteção são retornados no membro dwData como uma combinação de zero ou mais sinalizadores. Confira Sinalizadores de tipo de proteção COPP. Se mais de um mecanismo de proteção estiver disponível, os sinalizadores serão combinados com um OR bit a bit.
Consulta de sinalização
Retorna uma lista de todos os padrões de proteção compatíveis com o driver, o padrão que está ativo no momento e a taxa de proporção atual ou outros dados de sinalização.
- GUID: DXVA_COPPQuerySignaling
- Dados de entrada: nenhum.
- Retornar dados: retorna uma estrutura DXVA_COPPStatusSignalingCmdData .
Tópicos relacionados