Tspi_T...Events(3)

💖 Tspi_T...Events — TCG Software Stack Developer's Reference 💖

okay bestie, sit down, hydrate, and let me tell you about Tspi_TPM_GetEvents — she's a TSS 1.1 girly from the Trusted Computing Group and she is literally the plug for pulling PCR events out of your TPM. no cap. 🎀

✨ NAME ✨

Tspi_TPM_GetEvents — get a specific number of PCR events for a given index.

like. she gets you a specific number of events. for a given index. that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

#include <tss/platform.h>
#include <tss/tcpa_defines.h>
#include <tss/tcpa_typedef.h>
#include <tss/tcpa_struct.h>
#include <tss/tss_typedef.h>
#include <tss/tss_structs.h>
#include <tss/tspi.h>

TSS_RESULT Tspi_TPM_GetEvents(TSS_HTPM       hTPM,            UINT32  ulPcrIndex,
                              UINT32         ulStartNumber,   UINT32* pulEventNumber,
                              TSS_PCR_EVENT* prgbPcrEvents);

look at those includes. seven of them. she's high maintenance and honestly? deserved. 👑

🦋 DESCRIPTION 🦋

Tspi_TPM_GetEvents provides a specific number of PCR events for a given index.

that's it, that's the whole plot. you ask for some events, she hands you some events. iconic behavior, no notes. ✨

💜 PARAMETERS 💜

hTPM

Handle of the TPM object. your main character handle, basically. 🫶

ulPcrIndex

Index of the PCR to request. which PCR are we digging into bestie, that's the one. 🍓

ulStartNumber

Indext of the first event to request. (yes it says "Indext," the spec said what it said and we respect her) 🌈

pulEventNumber

[IN] Number of elements to request. [OUT] Receives number of returned event data structures in prgbPcrEvents parameter.

so she's doing double duty — you tell her how many you want, she tells you how many you got. multitasking queen. 👑

prgbPcrEvents

Receives a pointer to an array of PCR event data. If NULL, only the number of elements is returned in pulEventNumber parameter.

ooh this is the good part — pass NULL here and you get a lil sneak peek at how many events there are, without any of the actual event data. a vibe check, if you will. 💅

💀 RETURN CODES 💀

Tspi_TPM_GetEvents returns TSS_SUCCESS on success, otherwise one of the following values are returned:

• TSS_E_INVALID_HANDLE — hTPM is not a valid handle to the TPM object. bestie that handle is not real, she does not know her. 😭
• TSS_E_INTERNAL_ERROR — An error occurred internal to the TSS. something went wrong inside the TSS and honestly it's not your fault, fr fr.

🌈 CONFORMING TO 🌈

Tspi_TPM_GetEvents conforms to the Trusted Computing Group Software Specification version 1.1 Golden.

Golden! she's certified, she's spec-compliant, she's that girl. ⭐

🎀 SEE ALSO 🎀

• Tspi_TPM_GetEvent(3)
• Tspi_TPM_GetEventLog(3)

go read her sisters, they're all slaying in the same family. iykyk. 🧚

and that's the page!! brought to you by TSS 1.1, dated 2004-05-26 — she's been iconic since 2004 and she's still serving. mwah, love u, go log some events. 💖✨🦋🌸🎀💅🫶👑