Método IOPMVideoOutput::StartInitialization (opmapi.h)

Inicia a sequência de inicialização de uma sessão do OPM (Output Protection Manager).

Sintaxe

HRESULT StartInitialization(
  [out] OPM_RANDOM_NUMBER *prnRandomNumber,
  [out] BYTE              **ppbCertificate,
  [out] ULONG             *pulCertificateLength
);

Parâmetros

[out] prnRandomNumber

Ponteiro para uma estrutura OPM_RANDOM_NUMBER . A estrutura recebe um número aleatório de 128 bits gerado pelo driver de exibição. Esse número é necessário para o método IOPMVideoOutput::FinishInitialization .

[out] ppbCertificate

Recebe um ponteiro para um buffer que contém o certificado do driver de exibição. O método aloca a memória para o buffer. O chamador deve liberar a memória chamando CoTaskMemFree.

[out] pulCertificateLength

Recebe o comprimento do buffer apontado por ppbCertificate.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método é equivalente ao método IAMCertifiedOutputProtection::KeyExchange no COPP (Certified Output Protection Protocol).

O método retorna uma cadeia de certificados que contém a chave pública RSA de 2048 bits do driver. O chamador deve validar a cadeia de certificados e chamar IOPMVideoOutput::FinishInitialization para estabelecer a sessão OPM.

Esse método dá suporte à semântica do OPM e à semântica COPP. Há suporte para semântica copp para compatibilidade com versões anteriores; os novos aplicativos devem usar a semântica do OPM.

Semântica do OPM

O método retorna uma cadeia de certificados X.509. A cadeia de certificados é codificada com ASN.1 Distinguished Encoding Rules (DER).

Semântica copp

O método retorna uma cadeia de certificados COPP. A cadeia de certificados é retornada como uma cadeia de caracteres UTF-8. Você pode tratar o buffer retornado em ppbCertificate como uma matriz de chars.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	opmapi.h

Confira também

IOPMVideoOutput

Gerenciador de Proteção de Saída