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 狀態要求。
備註
初始化此結構,如下所示:
- 產生密碼編譯安全的 128 位亂數,並將它複製到 rnRandomNumber 成員。 呼叫 GetInformation之後,請勿重複使用此號碼。
- 填入其餘結構成員,但 omac 成員除外。
- 使用 OMAC 1 演算法來計算 mac (MAC) 訊息驗證碼,該區塊出現在 omac 成員之後 (排除 omac 成員) 。
- 將 MAC 複製到 omac 成員。
需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
標頭 | ksopmapi.h (包含 Opmapi.h) |