função Tbsi_Physical_Presence_Command (tbs.h)
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 |
|---|---|
|
A função foi bem-sucedida. |
|
Um ou mais valores de parâmetro não são válidos. |
|
Ocorreu um erro interno de software. |
|
Um parâmetro de contexto que não é válido foi passado ao tentar criar um contexto de TBS. |
|
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 |