共用方式為

Tbsi_Physical_Presence_Command函式 (tbs.h)

  • 發行項

透過 TBS 將實體目前狀態 ACPI 命令傳遞至驅動程式。

語法

TBS_RESULT Tbsi_Physical_Presence_Command(
  [in]      TBS_HCONTEXT hContext,
  [in]      PCBYTE       pabInput,
  [in]      UINT32       cbInput,
  [out]     PBYTE        pabOutput,
  [in, out] PUINT32      pcbOutput
);

參數

[in] hContext

ACPI 命令的內容。

[in] pabInput

緩衝區的指標，其中包含 ACPI 命令的輸入。

ACPI 命令的輸入是在 的 https://www.trustedcomputinggroup.orgTCG 實體存在介面規格中定義。緩衝區應該包含本文件中定義的 Arg2 和 Arg3 值。 Arg0 和 Arg1 的值是靜態且會自動新增。 例如，如果這個方法用於 Get Physical Presence Interface Version，則 Arg2 是整數值 1， 而 Arg3 是空的，因此緩衝區應該只包含 1 的整數值。 如果此方法用於「將 TPM 作業要求提交至預先 OS 環境」， 則 Arg2 是整數值 2， 而 Arg3 將會是指定作業的整數，例如 1 表示啟用或停用 2。

[in] cbInput

輸入緩衝區的長度 (以位元組為單位)。

[out] pabOutput

要包含 ACPI 命令輸出之緩衝區的指標。

緩衝區會包含命令的傳回值，如 TCG實體存在介面規格中所定義。

[in, out] pcbOutput

在輸入時，不帶正負號長整數的指標會指定輸出緩衝區的大小，以位元組為單位。 如果函式成功，這個參數會在輸出時接收 pabOutput 所指向數據的大小，以位元組為單位。 如果函式失敗，這個參數就不會收到值。

傳回值

如果函式成功，函式會傳回TBS_SUCCESS。

如果函式失敗，它會傳回指出錯誤的 TBS 傳回碼。

傳回碼/值 Description
TBS_SUCCESS
0 (0x0)
函式成功。
TBS_E_BAD_PARAMETER
2150121474 (0x80284002)
一或多個參數值無效。
TBS_E_INTERNAL_ERROR
2150121473 (0x80284001)
發生內部軟體錯誤。
TBS_E_INVALID_CONTEXT_PARAM
2150121479 (0x80284007)
嘗試建立 TBS 內容時，傳遞無效的內容參數。
TBS_E_INVALID_OUTPUT_POINTER
2150121475 (0x80284003)
指定的輸出指標無效。

備註

如需詳細資訊，請參閱 TCG 實體存在介面規格。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 tbs.h
程式庫 Tbs.lib
Dll Tbs.dll