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 命令的输入在 的 TCG 物理状态接口规范 中 https://www.trustedcomputinggroup.org定义。缓冲区应包含本文档中定义的 Arg2 和 Arg3 值。 Arg0 和 Arg1 的值是静态的，并且会自动添加。 例如，如果此方法用于获取物理状态接口版本，则 Arg2 为整数值 1，Arg3 为空，因此缓冲区应仅包含整数值 1。 如果此方法用于“将 TPM 操作请求提交到预 OS 环境”，则 Arg2 是整数值 2，Arg3 将是指定操作的整数，例如 1 表示 enable，2 表示禁用。

[in] cbInput

输入缓冲区的长度，以字节表示。

[out] pabOutput

指向缓冲区的指针，用于包含 ACPI 命令的输出。

缓冲区将包含 TCG 物理状态接口规范中定义的命令的返回值。

[in, out] pcbOutput

指向无符号长整数的指针，该整数在输入时指定输出缓冲区的大小（以字节为单位）。 如果函数成功，则此参数在输出时接收 pabOutput 指向的数据的大小（以字节为单位）。 如果函数失败，此参数不会收到值。

返回值

如果函数成功，该函数将返回TBS_SUCCESS。

如果函数失败，它将返回指示错误的 TBS 返回代码。

返回代码/值 说明
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
Library Tbs.lib
DLL Tbs.dll