IOPMVideoOutput::StartInitialization メソッド (opmapi.h)
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 |