TSPI_TPM_GETEVENT(3)

💖 Tspi_TPM_GetEvent 💖

okay bestie, welcome to the TCG Software Stack Developer's Reference — yes that's the manual we're in, and yes it's a whole vibe. this page is about Tspi_TPM_GetEvent, and we're gonna get you fluent, no cap. 🫶

✨ NAME ✨

Tspi_TPM_GetEvent — get a PCR event for a given PCR index and event number. it's giving "look up one specific thing in the event log," and honestly? iconic. 💅

🌸 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_GetEvent(TSS_HTPM hTPM,          UINT32         ulPcrIndex,
                             UINT32   ulEventNumber, TSS_PCR_EVENT* pPcrEvent);

like, include the headers, call the function, get your event. simple. gorgeous. ✨

🦋 DESCRIPTION 🦋

Tspi_TPM_GetEvent provides a PCR event for a given PCR index and event number. that's it, that's the whole job. you hand it a PCR index and an event number, and it hands you back the event. main character energy: it knows exactly what you're looking for and it delivers. 💜

🎀 PARAMETERS 🎀

• hTPM — handle of the TPM object. your TPM's lil ID card, basically.
• ulPcrIndex — index of the PCR to request. which PCR are we talking about, bestie?
• ulEventNumber — index of the event to request. which event in particular?
• pPcrEvent — receives the PCR event data. this is where the goods land. 🍓

💀 RETURN CODES 💀

Tspi_TPM_GetEvent returns TSS_SUCCESS on success — slay — otherwise one of the following values are returned:

• TSS_E_INVALID_HANDLE — hTPM is not a valid handle to the TPM object. the handle didn't pass the vibe check, sorry babe. 😭
• TSS_E_INTERNAL_ERROR — an error occurred internal to the TSS. not your fault, it's a them problem. 💀

👑 CONFORMING TO 👑

Tspi_TPM_GetEvent conforms to the Trusted Computing Group Software Specification version 1.1 Golden. periodt. we're standards-compliant and we're thriving. 🌈

🌟 SEE ALSO 🌟

• Tspi_TPM_GetEvents(3)
• Tspi_TPM_GetEventLog(3)

go read those too, bestie, the lore runs deep. 🧚

TSS 1.1 · 2004-05-26 — yeah she's an elder but she still ate, fr fr. that's the source/version and date, straight from the footer, mwah 💖✨🎀