Tbsi_Physical_Presence_Command関数 (tbs.h)

  • [アーティクル]

物理プレゼンス ACPI コマンドを TBS 経由でドライバーに渡します。

構文

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 の値は静的であり、自動的に追加されます。 たとえば、このメソッドを Get Physical Presence Interface Version に使用する場合、 Arg2 は整数値 1、 Arg3 は空であるため、バッファーには整数値 1 のみを含める必要があります。 このメソッドを "OS 前環境に TPM 操作要求を送信する" に使用する場合、 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)
 1 つ以上のパラメーター値が無効です。
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