OPM_GET_INFO_PARAMETERS結構 (opmapi.h)
包含 IOPMVideoOutput::GetInformation 方法的參數。
語法
typedef struct _OPM_GET_INFO_PARAMETERS {
OPM_OMAC omac;
OPM_RANDOM_NUMBER rnRandomNumber;
GUID guidInformation;
ULONG ulSequenceNumber;
ULONG cbParametersSize;
BYTE abParameters[4056];
} 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[4056]
狀態要求的數據。 數據的意義取決於要求。 如需詳細資訊,請參閱 OPM 狀態要求。
備註
初始化此結構,如下所示:
- 產生密碼編譯安全的 128 位隨機數,並將它複製到 rnRandomNumber 成員。 呼叫 GetInformation 之後,請勿重複使用此號碼。
- 填入其餘結構成員,但 omac 成員除外。
- 使用 OMAC 1 演演算法來計算 mac (MAC) 訊息驗證碼,該區塊出現在 omac 成員之後 (排除 omac 成員) 。
- 將 MAC 複製到 omac 成員。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
標頭 | opmapi.h (包含 Opmapi.h) |