IOPMVideoOutput：：StartInitialization 方法 (opmapi.h)

發行項
03/13/2024

開始輸出保護管理員 (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

Share via