Tbsi_Physical_Presence_Command, fonction (tbs.h)

Article
03/06/2024

Transmet au pilote une commande ACPI de présence physique via TBS.

Syntaxe

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

Paramètres

[in] hContext

Contexte de la commande ACPI.

[in] pabInput

Pointeur vers une mémoire tampon qui contient l’entrée de la commande ACPI.

L’entrée de la commande ACPI est définie dans la spécification de l’interface de présence physique TCG à l’adresse https://www.trustedcomputinggroup.org. La mémoire tampon doit contenir les valeurs Arg2 et Arg3 définies dans ce document. Les valeurs pour Arg0 et Arg1 sont statiques et ajoutées automatiquement. Par exemple, si cette méthode est utilisée pour Obtenir la version de l’interface de présence physique, Arg2 est la valeur entière 1 et Arg3 est vide. La mémoire tampon doit donc simplement contenir une valeur entière de 1. Si cette méthode est utilisée pour « Envoyer une demande d’opération TPM à l’environnement pré-système d’exploitation », Arg2 est la valeur entière 2 et Arg3 est l’entier pour l’opération spécifiée, par exemple 1 pour activer ou 2 pour désactiver.

[in] cbInput

Longueur en octets de la mémoire tampon d'entrée.

[out] pabOutput

Pointeur vers une mémoire tampon pour contenir la sortie de la commande ACPI.

La mémoire tampon contient la valeur de retour de la commande, comme défini dans la spécification de l’interface de présence physique TCG.

[in, out] pcbOutput

Pointeur vers un entier long non signé qui, à l’entrée, spécifie la taille, en octets, de la mémoire tampon de sortie. Si la fonction réussit, ce paramètre, en sortie, reçoit la taille, en octets, des données pointées par pabOutput. Si la fonction échoue, ce paramètre ne reçoit pas de valeur.

Valeur retournée

Si la fonction réussit, la fonction retourne TBS_SUCCESS.

Si la fonction échoue, elle retourne un code de retour TBS qui indique l’erreur.

Code/valeur de retour	Description
TBS_SUCCESS 0 (0x0)	La fonction a réussi.
TBS_E_BAD_PARAMETER 2150121474 (0x80284002)	Une ou plusieurs valeurs de paramètre ne sont pas valides.
TBS_E_INTERNAL_ERROR 2150121473 (0x80284001)	Une erreur interne du logiciel s'est produite.
TBS_E_INVALID_CONTEXT_PARAM 2150121479 (0x80284007)	Un paramètre de contexte non valide a été passé lors de la tentative de création d’un contexte TBS.
TBS_E_INVALID_OUTPUT_POINTER 2150121475 (0x80284003)	Un pointeur de sortie spécifié n’est pas valide.

Remarques

Pour plus d’informations, consultez Spécification de l’interface de présence physique TCG.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tbs.h
Bibliothèque	Tbs.lib
DLL	Tbs.dll

Partager via