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

OPM_OMAC結構，其中包含結構其餘部分資料的訊息驗證碼 (MAC) 。

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 演算法來計算 mac (MAC) 訊息驗證碼，該區塊出現在 omac 成員之後 (排除 omac 成員) 。
  4. 將 MAC 複製到 omac 成員。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 ksopmapi.h (包含 Opmapi.h)

另請參閱

OPM 結構

Output Protection Manager