funzione Tbsi_Physical_Presence_Command (tbs.h)

Articolo
03/13/2024

Passa un comando ACPI di presenza fisica tramite TBS al driver.

Sintassi

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

Parametri

[in] hContext

Contesto del comando ACPI.

[in] pabInput

Puntatore a un buffer contenente l'input per il comando ACPI.

L'input per il comando ACPI è definito nella specifica TCG Physical Presence Interface all'indirizzo https://www.trustedcomputinggroup.org. Il buffer deve contenere valori Arg2 e Arg3 , come definito in questo documento. I valori per Arg0 e Arg1 sono statici e aggiunti automaticamente. Ad esempio, se questo metodo viene usato per Get Physical Presence Interface Version, Arg2 è il valore intero 1 e Arg3 è vuoto, quindi il buffer deve contenere solo un valore intero pari a 1. Se questo metodo viene usato per "Submit TPM Operation Request to Pre-OS Environment", Arg2 è il valore intero 2 e Arg3 sarà il numero intero per l'operazione specificata, ad esempio 1 per enable o 2 per disable.

[in] cbInput

Lunghezza, in byte, del buffer di input.

[out] pabOutput

Puntatore a un buffer per contenere l'output del comando ACPI.

Il buffer conterrà il valore restituito dal comando come definito nella specifica TCG Physical Presence Interface.

[in, out] pcbOutput

Puntatore a un intero long senza segno che, all'input, specifica le dimensioni, in byte, del buffer di output. Se la funzione ha esito positivo, questo parametro, nell'output, riceve le dimensioni, in byte, dei dati a cui punta pabOutput. Se la funzione non riesce, questo parametro non riceve un valore.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TBS_SUCCESS.

Se la funzione ha esito negativo, restituisce un codice restituito TBS che indica l'errore.

Codice/valore restituito	Descrizione
TBS_SUCCESS 0 (0x0)	La funzione ha avuto esito positivo.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Uno o più valori di parametro non sono validi.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Si è verificato un errore interno del software.
TBS_E_INVALID_CONTEXT_PARAM 2150121479 (0x80284007)	È stato passato un parametro di contesto non valido quando si tenta di creare un contesto TBS.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Un puntatore di output specificato non è valido.

Commenti

Per altre informazioni, vedere TCG Physical Presence Interface Specification.For more information, see TCG Physical Presence Interface Specification.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tbs.h
Libreria	Tbs.lib
DLL	Tbs.dll

Condividi tramite