OPM_GET_INFO_PARAMETERS 構造体 (ksopmapi.h)

IOPMVideoOutput::GetInformation メソッドのパラメーターが含まれています。

構文

typedef struct _OPM_GET_INFO_PARAMETERS {
  OPM_OMAC          omac;
  OPM_RANDOM_NUMBER rnRandomNumber;
  GUID              guidInformation;
  ULONG             ulSequenceNumber;
  ULONG             cbParametersSize;
  BYTE              abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE];
} OPM_GET_INFO_PARAMETERS;

メンバー

omac

構造体の残りの部分にあるデータのメッセージ認証コード (MAC) を含む OPM_OMAC 構造体。

rnRandomNumber

暗号で保護された 128 ビット乱数を含むOPM_RANDOM_NUMBER構造体。

guidInformation

状態要求を定義する GUID。 詳細については、「 OPM 状態要求」を参照してください。

ulSequenceNumber

状態シーケンス番号。 アプリケーションは、状態要求の実行中の数を保持する必要があります。 要求ごとに、シーケンス番号を 1 ずつインクリメントします。

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

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

cbParametersSize

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

abParameters[OPM_GET_INFORMATION_PARAMETERS_SIZE]

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

解説

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

1. 暗号で保護された 128 ビット乱数を生成し、 rnRandomNumber メンバーにコピーします。 GetInformation を呼び出した後は、この番号を再利用しないでください。
2. omac メンバーを除き、残りの構造体メンバーを入力します。
3. OMAC 1 アルゴリズムを使用して、 omac メンバー ( omac メンバーを除く) の後に表示されるデータ ブロックのメッセージ認証コード (MAC) を計算します。
4. MAC を omac メンバーにコピーします。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	ksopmapi.h (Opmapi.h を含む)

関連項目

OPM 構造体

Output Protection Manager