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 (MAC) ，填入此結構。 使用 AES 型單鍵 CBC MAC (OMAC) 來計算此值。

guidSetting

指定命令的 GUID。 如需詳細資訊，請參閱 OPM 命令。

ulSequenceNumber

命令序號。 應用程式必須保留所發出命令的執行計數。 針對每個命令，將序號遞增一。

在第一次呼叫 IOPMVideoOutput：：Configure 時，將 ulSequenceNumber 設定為等於起始命令序號，這會在應用程式呼叫 IOPMVideoOutput：：FinishInitialization 時指定。 在每個後續呼叫上，將 ulSequenceNumber 遞增1。

例外狀況：如果 IOPMVideoOutput：：Configure 方法失敗，請勿遞增序號。 相反地，請針對下一個命令重複使用相同的數位。

cbParametersSize

abParameters 成員中有效數據的位元元組數。

abParameters[4056]

命令的數據。 數據的意義取決於 命令。 如需詳細資訊，請參閱 OPM 命令。

備註

此結構的版面配置與認證輸出保護通訊協定 (COPP) 中使用的 AMCOPPCommand 結構相同。

初始化這個結構，如下所示。

  1. 填入 omac 成員以外的所有結構成員。
  2. 使用 OMAC 1 演演算法來計算 mac (MAC) 訊息驗證碼，該區塊出現在 omac 成員之後 (排除 omac 成員) 。
  3. 將 MAC 複製到 omac 成員。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 opmapi.h

另請參閱

IOPMVideoOutput：：Configure

OPM 結構

Output Protection Manager