Compartir a través de

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

  • Artículo

Completa la secuencia de inicialización de una sesión de Output Protection Manager (OPM).

Sintaxis

HRESULT FinishInitialization(
  [in] const OPM_ENCRYPTED_INITIALIZATION_PARAMETERS *pParameters
);

Parámetros

[in] pParameters

Puntero a una estructura de OPM_ENCRYPTED_INITIALIZATION_PARAMETERS . Inicialice esta estructura como se describe en la sesión comentarios.

Valor devuelto

Devuelve un VALOR HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
ERROR_GRAPHICS_OPM_DRIVER_INTERNAL_ERROR
 Se produjo un error inesperado en el controlador de pantalla.
ERROR_GRAPHICS_OPM_INVALID_ENCRYPTED_PARAMETERS
 Los parámetros cifrados de pParameters son incorrectos .

Comentarios

Este método es equivalente al método IAMCertifiedOutputProtection::SessionSequenceStart en el Protocolo de protección de salida certificada (COPP).

El parámetro pParameters apunta a una estructura de OPM_ENCRYPTED_INITIALIZATION_PARAMETERS que contiene una matriz de 256 bytes. Antes de llamar al método , prepare esta matriz de la siguiente manera. En primer lugar, concatene los números siguientes:

  • Número de 128 bits devuelto en el parámetro prnRandomNumber del método IOPMVideoOutput::StartInitialization .
  • Clave de firma de AES. Este valor es un número aleatorio de 128 bits generado por la aplicación.
  • Número de secuencia inicial para las solicitudes de estado de OPM. Este valor es un número aleatorio de 32 bits generado por la aplicación.
  • Número de secuencia inicial para los comandos de OPM. Este valor es un número aleatorio de 32 bits generado por la aplicación.
Cifre este número con RAEAS-OAEP, cifrado mediante la clave de cifrado pública del controlador de pantalla. La clave de cifrado pública se encuentra en el certificado devuelto en el parámetro ppbCertificate del método StartInitialization .

La aplicación debe usar números aleatorios criptográficos seguros. Se recomienda la función CryptGenRandom , aunque no es necesario.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado opmapi.h

Consulte también

IOPMVideoOutput

Administrador de protección de salida