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 構造体と同じです。
この構造体を次のように初期化します。
- omac メンバーを除くすべての構造体メンバーを入力します。
- OMAC 1 アルゴリズムを使用して、 omac メンバー ( omac メンバーを除く) の後に表示されるデータ ブロックのメッセージ認証コード (MAC) を計算します。
- MAC を omac メンバーにコピーします。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | opmapi.h |