Tbsi_Physical_Presence_Command-Funktion (tbs.h)

Artikel
03/02/2024

Übergibt einen ACPI-Befehl für physische Anwesenheit über TBS an den Treiber.

Syntax

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

Der Kontext des ACPI-Befehls.

[in] pabInput

Ein Zeiger auf einen Puffer, der die Eingabe zum ACPI-Befehl enthält.

Die Eingabe für den ACPI-Befehl wird in der TCG Physical Presence Interface Specification unter https://www.trustedcomputinggroup.orgdefiniert. Der Puffer sollte Arg2 - und Arg3-Werte enthalten, wie in diesem Dokument definiert. Die Werte für Arg0 und Arg1 sind statisch und werden automatisch hinzugefügt. Wenn diese Methode beispielsweise für Get Physical Presence Interface Version verwendet wird, ist Arg2 der ganzzahlige Wert 1 und Arg3 ist leer, sodass der Puffer nur den ganzzahligen Wert 1 enthalten sollte. Wenn diese Methode für "Tpm-Vorgangsanforderung an Pre-OS-Umgebung übermitteln" verwendet wird, ist Arg2 der ganzzahlige Wert 2, und Arg3 ist die ganze Zahl für den angegebenen Vorgang, z. B. 1 für aktivieren oder 2 für deaktivieren.

[in] cbInput

Die Länge des Eingabepuffers in Bytes.

[out] pabOutput

Ein Zeiger auf einen Puffer, der die Ausgabe des ACPI-Befehls enthält.

Der Puffer enthält den Rückgabewert des Befehls, wie in der TCG Physical Presence Interface Specification definiert.

[in, out] pcbOutput

Ein Zeiger auf eine lange ganzzahlige Zahl ohne Vorzeichen, die bei der Eingabe die Größe des Ausgabepuffers in Bytes angibt. Wenn die Funktion erfolgreich ist, empfängt dieser Parameter bei der Ausgabe die Größe der Daten in Bytes, auf die von pabOutput verwiesen wird. Wenn die Funktion fehlschlägt, erhält dieser Parameter keinen Wert.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion TBS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, gibt sie einen TBS-Rückgabecode zurück, der den Fehler angibt.

Rückgabecode/-wert	BESCHREIBUNG
TBS_SUCCESS 0 (0x0)	Die Funktion war erfolgreich.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Mindestens ein Parameterwert ist ungültig.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Interner Softwarefehler.
TBS_E_INVALID_CONTEXT_PARAM 2150121479 (0x80284007)	Beim Erstellen eines TBS-Kontexts wurde ein ungültiger Kontextparameter übergeben.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Ein angegebener Ausgabezeiger ist ungültig.

Hinweise

Weitere Informationen finden Sie unter TcG Physical Presence Interface Specification .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tbs.h
Bibliothek	Tbs.lib
DLL	Tbs.dll