OPM_CONFIGURE_PARAMETERS 構造体 (opmapi.h)

Output Protection Manager (OPM) または Certified Output Protection Manager (COPP) コマンドが含まれています。

構文

typedef struct _OPM_CONFIGURE_PARAMETERS {
  OPM_OMAC omac;
  GUID     guidSetting;
  ULONG    ulSequenceNumber;
  ULONG    cbParametersSize;
  BYTE     abParameters[4056];
} OPM_CONFIGURE_PARAMETERS;

メンバー

omac

OPM_MAC構造体。 この構造体にコマンド データのメッセージ認証コード (MAC) を入力します。 この値を計算するには、AES ベースの 1 キー CBC MAC (OMAC) を使用します。

guidSetting

コマンドを指定する GUID。 詳細については、「 OPM コマンド」を参照してください。

ulSequenceNumber

コマンド シーケンス番号。 アプリケーションは、発行されたコマンドの実行数を保持する必要があります。 コマンドごとに、シーケンス番号を 1 ずつインクリメントします。

IOPMVideoOutput::Configure の最初の呼び出しで、ulSequenceNumber を開始コマンド シーケンス番号と同じ値に設定します。これは、アプリケーションが IOPMVideoOutput::FinishInitialization を呼び出すときに指定されます。 後続の各呼び出しで、 ulSequenceNumber を 1 ずつインクリメントします。

例外: IOPMVideoOutput::Configure メソッドが失敗した場合は、シーケンス番号をインクリメントしないでください。 代わりに、次のコマンドに同じ番号を再利用してください。

cbParametersSize

abParameters メンバー内の有効なデータのバイト数。

abParameters[4056]

コマンドのデータ。 データの意味は コマンドによって異なります。 詳細については、「 OPM コマンド」を参照してください。

注釈

この構造のレイアウトは、認定出力保護プロトコル (COPP) で使用される AMCOPPCommand 構造体と同じです。

この構造体を次のように初期化します。

1. omac メンバーを除くすべての構造体メンバーを入力します。
2. OMAC 1 アルゴリズムを使用して、 omac メンバー ( omac メンバーを除く) の後に表示されるデータ ブロックのメッセージ認証コード (MAC) を計算します。
3. MAC を omac メンバーにコピーします。

要件

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

こちらもご覧ください

IOPMVideoOutput::Configure

OPM 構造体

Output Protection Manager