função Tbsi_Physical_Presence_Command (tbs.h)

  • Artigo

Passa um comando ACPI de presença física por meio do TBS para o driver.

Sintaxe

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

O contexto do comando ACPI.

[in] pabInput

Um ponteiro para um buffer que contém a entrada para o comando ACPI.

A entrada para o comando ACPI é definida na Especificação da Interface de Presença Física do TCG em https://www.trustedcomputinggroup.org. O buffer deve conter valores Arg2 e Arg3 , conforme definido neste documento. Os valores de Arg0 e Arg1 são estáticos e adicionados automaticamente. Por exemplo, se esse método for usado para Obter Versão da Interface de Presença Física, Arg2 será o valor inteiro 1 e Arg3 estará vazio, portanto, o buffer deve conter apenas um valor inteiro de 1. Se esse método for usado para "Enviar Solicitação de Operação do TPM para o Ambiente do Pré-SO", Arg2 será o valor inteiro 2 e Arg3 será o inteiro da operação especificada, como 1 para habilitar ou 2 para desabilitar.

[in] cbInput

O comprimento, em bytes, do buffer de entrada.

[out] pabOutput

Um ponteiro para um buffer para conter a saída do comando ACPI.

O buffer conterá o valor retornado do comando, conforme definido na Especificação da Interface de Presença Física do TCG.

[in, out] pcbOutput

Um ponteiro para um inteiro longo sem sinal que, na entrada, especifica o tamanho, em bytes, do buffer de saída. Se a função for bem-sucedida, esse parâmetro, na saída, receberá o tamanho, em bytes, dos dados apontados por pabOutput. Se a função falhar, esse parâmetro não receberá um valor.

Retornar valor

Se a função for bem-sucedida, a função retornará TBS_SUCCESS.

Se a função falhar, ela retornará um código de retorno de TBS que indica o erro.

Valor/código retornado Descrição
TBS_SUCCESS
0 (0x0)
 A função foi bem-sucedida.
TBS_E_BAD_PARAMETER
2150121474 (0x80284002)
 Um ou mais valores de parâmetro não são válidos.
TBS_E_INTERNAL_ERROR
2150121473 (0x80284001)
 Ocorreu um erro interno de software.
TBS_E_INVALID_CONTEXT_PARAM
2150121479 (0x80284007)
 Um parâmetro de contexto que não é válido foi passado ao tentar criar um contexto de TBS.
TBS_E_INVALID_OUTPUT_POINTER
2150121475 (0x80284003)
 Um ponteiro de saída especificado não é válido.

Comentários

Para obter mais informações, consulte Especificação da interface de presença física do TCG.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho tbs.h
Biblioteca Tbs.lib
DLL Tbs.dll