función Tbsi_Physical_Presence_Command (tbs.h)

Pasa un comando ACPI de presencia física a través de TBS al controlador.

Sintaxis

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

Parámetros

[in] hContext

Contexto del comando ACPI.

[in] pabInput

Puntero a un búfer que contiene la entrada al comando ACPI.

La entrada para el comando ACPI se define en la especificación de la interfaz de presencia física de TCG en https://www.trustedcomputinggroup.org. El búfer debe contener valores Arg2 y Arg3 , tal como se define en este documento. Los valores de Arg0 y Arg1 son estáticos y se agregan automáticamente. Por ejemplo, si este método se usa para Obtener versión de la interfaz de presencia física, Arg2 es el valor entero 1 y Arg3 está vacío, por lo que el búfer solo debe contener un valor entero de 1. Si este método se usa para "Enviar solicitud de operación de TPM al entorno anterior al sistema operativo", Arg2 es el valor entero 2 y Arg3 será el entero para la operación especificada, como 1 para habilitar o 2 para deshabilitar.

[in] cbInput

Longitud, en bytes, del búfer de entrada.

[out] pabOutput

Puntero a un búfer que contiene la salida del comando ACPI.

El búfer contendrá el valor devuelto del comando tal y como se define en la especificación de la interfaz de presencia física de TCG.

[in, out] pcbOutput

Puntero a un entero largo sin signo que, en la entrada, especifica el tamaño, en bytes, del búfer de salida. Si la función se ejecuta correctamente, este parámetro, en la salida, recibe el tamaño, en bytes, de los datos a los que apunta pabOutput. Si se produce un error en la función, este parámetro no recibe un valor.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve TBS_SUCCESS.

Si se produce un error en la función, devuelve un código de retorno TBS que indica el error.

Código o valor devuelto	Descripción
TBS_SUCCESS 0 (0x0)	La función se realizó correctamente.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Uno o varios valores de parámetro no son válidos.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Error interno de software.
TBS_E_INVALID_CONTEXT_PARAM 2150121479 (0x80284007)	Se pasó un parámetro de contexto que no es válido al intentar crear un contexto TBS.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Un puntero de salida especificado no es válido.

Comentarios

Para obtener más información, consulte Especificación de la interfaz de presencia física de TCG.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tbs.h
Library	Tbs.lib
Archivo DLL	Tbs.dll