Metodo IOPMVideoOutput::StartInitialization (opmapi.h)
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 |