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

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

Sintaxis

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

Parámetros

[out] prnRandomNumber

Puntero a una estructura de OPM_RANDOM_NUMBER . La estructura recibe un número aleatorio de 128 bits generado por el controlador de pantalla. Este número es necesario para el método IOPMVideoOutput::FinishInitialization .

[out] ppbCertificate

Recibe un puntero a un búfer que contiene el certificado del controlador de pantalla. El método asigna la memoria para el búfer. El autor de la llamada debe liberar la memoria llamando a CoTaskMemFree.

[out] pulCertificateLength

Recibe la longitud del búfer al que apunta ppbCertificate.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

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

El método devuelve una cadena de certificados que contiene la clave pública RSA de 2048 bits del controlador. El autor de la llamada debe validar la cadena de certificados y, a continuación, llamar a IOPMVideoOutput::FinishInitialization para establecer la sesión de OPM.

Este método admite tanto la semántica de OPM como la semántica de COPP. La semántica copP se admite para la compatibilidad con versiones anteriores; Las nuevas aplicaciones deben usar la semántica de OPM.

Semántica de OPM

El método devuelve una cadena de certificados X.509. La cadena de certificados se codifica con ASN.1 reglas de codificación distinguida (DER).

Semántica de COPP

El método devuelve una cadena de certificados COPP. La cadena de certificados se devuelve como una cadena UTF-8. Puede tratar el búfer devuelto en ppbCertificate como una matriz de caracteres.

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