Metodo IOPMVideoOutput::StartInitialization (opmapi.h)

Articolo
03/15/2023

Avvia la sequenza di inizializzazione per una sessione OPM (Output Protection Manager).

Sintassi

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

Parametri

[out] prnRandomNumber

Puntatore a una struttura OPM_RANDOM_NUMBER . La struttura riceve un numero casuale a 128 bit generato dal driver di visualizzazione. Questo numero è necessario per il metodo IOPMVideoOutput::FinishInitialization .

[out] ppbCertificate

Riceve un puntatore a un buffer contenente il certificato del driver visualizzato. Il metodo alloca la memoria per il buffer. Il chiamante deve rilasciare la memoria chiamando CoTaskMemFree.

[out] pulCertificateLength

Riceve la lunghezza del buffer a cui punta ppbCertificate.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo equivale al metodo IAMCertifiedOutputProtection::KeyExchange nel protocollo COPP (Certified Output Protection Protocol).

Il metodo restituisce una catena di certificati contenente la chiave pubblica RSA a 2048 bit del driver. Il chiamante deve convalidare la catena di certificati e quindi chiamare IOPMVideoOutput::FinishInitialization per stabilire la sessione OPM.

Questo metodo supporta sia la semantica OPM che la semantica COPP. La semantica COPP è supportata per la compatibilità con le versioni precedenti; le nuove applicazioni devono usare la semantica OPM.

Semantica OPM

Il metodo restituisce una catena di certificati X.509. La catena di certificati viene codificata con ASN.1 Distinguished Encoding Rules (DER).

Semantica COPP

Il metodo restituisce una catena di certificati COPP. La catena di certificati viene restituita come stringa UTF-8. È possibile trattare il buffer restituito in ppbCertificate come matrice di chars.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	opmapi.h

Vedi anche

IOPMVideoOutput

Output Protection Manager

Condividi tramite