IOPMVideoOutput::StartInitialization メソッド (opmapi.h)

[アーティクル]
03/01/2024

Output Protection Manager (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 エラーコードを返します。

注釈

このメソッドは、認定出力保護プロトコル (COPP) の IAMCertifiedOutputProtection::KeyExchange メソッドと同じです。

メソッドは、ドライバーの 2048 ビット RSA 公開キーを含む証明書チェーンを返します。呼び出し元は証明書チェーンを検証し、 IOPMVideoOutput::FinishInitialization を呼び出して OPM セッションを確立する必要があります。

このメソッドは、OPM セマンティクスと COPP セマンティクスの両方をサポートします。 COPP セマンティクスは下位互換性のためにサポートされています。新しいアプリケーションでは OPM セマンティクスを使用する必要があります。

OPM セマンティクス

メソッドは X.509 証明書チェーンを返します。証明書チェーンは、ASN.1 Distinguished Encoding Rules (DER) でエンコードされます。

COPP セマンティクス

メソッドは COPP 証明書チェーンを返します。証明書チェーンは UTF-8 文字列として返されます。 ppbCertificate で返されるバッファーは、chars の配列として扱うことができます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	opmapi.h

こちらもご覧ください

IOPMVideoOutput

Output Protection Manager