共用方式為


IOPMVideoOutput::StartInitialization 方法 (opmapi.h)

開始輸出保護管理員 (OPM) 工作階段的初始化順序。

語法

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

參數

[out] prnRandomNumber

OPM_RANDOM_NUMBER 結構的指標。 結構會收到顯示驅動程式所產生的128位隨機數。 IOPMVideoOutput::FinishInitialization 方法需要這個數位。

[out] ppbCertificate

接收緩衝區的指標,其中包含顯示驅動程序的憑證。 方法會配置緩衝區的記憶體。 呼叫端必須呼叫 CoTaskMemFree 來釋放記憶體。

[out] pulCertificateLength

接收 ppbCertificate所指向的緩衝區長度。

傳回值

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

這個方法相當於認證輸出保護通訊協定中的 IAMCertifiedOutputProtection::KeyExchange 方法, (COPP) 。

方法會傳回憑證鏈結,其中包含驅動程式的 2048 位 RSA 公鑰。 呼叫端必須驗證憑證鏈結,然後呼叫 IOPMVideoOutput::FinishInitialization 來建立 OPM 會話。

此方法同時支援 OPM 語意和 COPP 語意。 回溯兼容性支援COPP語意;新的應用程式應該使用 OPM 語意。

OPM 語意

方法會傳回 X.509 憑證鏈結。 憑證鏈結會以 ASN.1 編碼 可辨別編碼規則 (DER) 。

COPP 語意

方法會傳回 COPP 憑證鏈結。 憑證鏈結會以UTF-8字串的形式傳回。 您可以將 ppbCertificate 中傳回的緩衝區視為 chars 的陣列。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 opmapi.h

另請參閱

IOPMVideoOutput

Output Protection Manager