Método IAMCertifiedOutputProtection::SessionSequenceStart (strmif.h)

  • Artigo

[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.]

O SessionSequenceStart método inicia a sessão COPP com o driver gráfico.

Sintaxe

HRESULT SessionSequenceStart(
  [in] AMCOPPSignature *pSig
);

Parâmetros

[in] pSig

Ponteiro para uma estrutura AMCOPPSignature . Preencha essa estrutura conforme descrito na sessão Comentários.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
 Êxito.
E_UNEXPECTED
 Estado inválido. Possivelmente, o aplicativo passou dados inesperados ou chamou métodos IAMCertifiedOutputProtection na ordem errada.
VFW_E_NO_COPP_HW
 O dispositivo de exibição não dá suporte a COPP; ou a VMR ainda não se conectou a um dispositivo de exibição.

Comentários

Para preencher a estrutura do parâmetro pSig , primeiro concatene os seguintes números:

  • O número de 128 bits retornado no parâmetro pRandom do método IAMCertifiedOutputProtection::KeyExchange .
  • Chave de sessão de integridade de dados. Esse valor é um número aleatório de 128 bits gerado pelo aplicativo.
  • Número de sequência inicial para solicitações de status COPP. Esse valor é um número aleatório de 32 bits gerado pelo aplicativo.
  • Número de sequência inicial para comandos COPP. Esse valor é um número aleatório de 32 bits gerado pelo aplicativo.
Em seguida, criptografe esse número com criptografia RSA de 2048 bits usando a chave de criptografia pública do driver gráfico. A chave de criptografia pública está contida no certificado retornado no parâmetro VarLenCertGH do método KeyExchange .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

IAMCertifiedOutputProtection Interface

Usando o COPP (Certified Output Protection Protocol)