fungsi Tbsi_Physical_Presence_Command (tbs.h)

Artikel
03/02/2024

Meneruskan perintah ACPI kehadiran fisik melalui TBS ke driver.

Sintaks

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

Parameter

[in] hContext

Konteks perintah ACPI.

[in] pabInput

Penunjuk ke buffer yang berisi input ke perintah ACPI.

Input ke perintah ACPI didefinisikan dalam Spesifikasi Antarmuka Kehadiran Fisik TCG di https://www.trustedcomputinggroup.org. Buffer harus berisi nilai Arg2 dan Arg3 seperti yang didefinisikan dalam dokumen ini. Nilai untuk Arg0 dan Arg1 statis dan secara otomatis ditambahkan. Misalnya, jika metode ini digunakan untuk Dapatkan Versi Antarmuka Kehadiran Fisik, maka Arg2 adalah nilai bilangan bulat 1 dan Arg3 kosong, sehingga buffer hanya boleh berisi nilai bilangan bulat 1. Jika metode ini digunakan untuk "Kirim Permintaan Operasi TPM ke Lingkungan Pra-OS", maka Arg2 adalah nilai bilangan bulat 2 dan Arg3 akan menjadi bilangan bulat untuk operasi yang ditentukan, seperti 1 untuk diaktifkan atau 2 untuk dinonaktifkan.

[in] cbInput

Panjang, dalam byte, dari buffer input.

[out] pabOutput

Penunjuk ke buffer untuk berisi output perintah ACPI.

Buffer akan berisi nilai pengembalian dari perintah seperti yang didefinisikan dalam Spesifikasi Antarmuka Kehadiran Fisik TCG.

[in, out] pcbOutput

Penunjuk ke bilangan bulat panjang yang tidak ditandatangani yang, pada input, menentukan ukuran, dalam byte, dari buffer output. Jika fungsi berhasil, parameter ini, pada output, menerima ukuran, dalam byte, dari data yang diacu oleh pabOutput. Jika fungsi gagal, parameter ini tidak menerima nilai.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan TBS_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan kode pengembalian TBS yang menunjukkan kesalahan.

Mengembalikan kode/nilai	Deskripsi
TBS_SUCCESS 0 (0x0)	Fungsi berhasil.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Satu atau beberapa nilai parameter tidak valid.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Terjadi kesalahan perangkat lunak internal.
TBS_E_INVALID_CONTEXT_PARAM 2150121479 (0x80284007)	Parameter konteks yang tidak valid diteruskan saat mencoba membuat konteks TBS.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Penunjuk output yang ditentukan tidak valid.

Keterangan

Untuk informasi selengkapnya, lihat Spesifikasi Antarmuka Kehadiran Fisik TCG.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	tbs.h
Pustaka	Tbs.lib
DLL	Tbs.dll

Bagikan melalui