IOPMVideoOutput::FinishInitialization-Methode (opmapi.h)

  • Artikel

Schließt die Initialisierungssequenz für eine OPM-Sitzung (Output Protection Manager) ab.

Syntax

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

Parameter

[in] pParameters

Zeiger auf eine OPM_ENCRYPTED_INITIALIZATION_PARAMETERS-Struktur . Initialisieren Sie diese Struktur wie in der Sitzung "Hinweise" beschrieben.

Rückgabewert

Gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
ERROR_GRAPHICS_OPM_DRIVER_INTERNAL_ERROR
 Beim Anzeigetreiber ist ein unerwarteter Fehler aufgetreten.
ERROR_GRAPHICS_OPM_INVALID_ENCRYPTED_PARAMETERS
 Die verschlüsselten Parameter in pParameters sind falsch.

Hinweise

Diese Methode entspricht der IAMCertifiedOutputProtection::SessionSequenceStart-Methode im Certified Output Protection Protocol (COPP).

Der pParameters-Parameter verweist auf eine OPM_ENCRYPTED_INITIALIZATION_PARAMETERS Struktur, die ein 256-Byte-Array enthält. Bevor Sie die Methode aufrufen, bereiten Sie dieses Array wie folgt vor. Verketten Sie zunächst die folgenden Zahlen:

  • Die im PrnRandomNumber-Parameter der IOPMVideoOutput::StartInitialization-Methode zurückgegebene 128-Bit-Zahl.
  • Der AES-Signaturschlüssel. Dieser Wert ist eine von der Anwendung generierte 128-Bit-Zufallszahl.
  • Die anfängliche Sequenznummer für OPM status Anforderungen. Dieser Wert ist eine von der Anwendung generierte 32-Bit-Zufallszahl.
  • Die anfängliche Sequenznummer für OPM-Befehle. Dieser Wert ist eine von der Anwendung generierte 32-Bit-Zufallszahl.
Verschlüsseln Sie diese Nummer mit RAEAS-OAEP, Verschlüsselung mithilfe des öffentlichen Verschlüsselungsschlüssels des Anzeigetreibers. Der öffentliche Verschlüsselungsschlüssel ist im Zertifikat enthalten, das im ppbCertificate-Parameter der StartInitialization-Methode zurückgegeben wird.

Die Anwendung muss kryptografisch sichere Zufallszahlen verwenden. Die CryptGenRandom-Funktion wird empfohlen, ist jedoch nicht erforderlich.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile opmapi.h

Weitere Informationen

IOPMVideoOutput

Ausgabeschutz-Manager