Tspi_C...bility(3)

💖 Tspi_Context_GetCapability 💖

okay so bestie, welcome to the TCG Software Stack Developer's Reference, page Tspi_C...bility(3) — yes the title got cut off like a bad selfie crop, but it's Tspi_Context_GetCapability fr fr. sit down, hydrate, and let's get into it 🫶

---

✨ NAME ✨

Tspi_Context_GetCapability — the function that spills the tea on what a TSS Core Service, a TSS Service Provider, or a TPM can actually do. it's giving "so tell me everything about yourself" 💅

---

✨ 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_Context_GetCapability(TSS_HCONTEXT hContext,          TSS_FLAG capArea,
                                      UINT32       ulSubCapLength,    BYTE*    rgbSubCap,
                                      UINT32*      pulRespDataLength, BYTE**   prgbRespData);

like yes, all seven includes, we don't skip a single one, no cap 🎀

---

🌸 DESCRIPTION 🌸

TSS_Context_GetCapability provides the capabilities of the TSS Core Service or TSS Service Provider. that's it, that's the whole vibe — you ask, it tells you what it's working with 💖

---

🦋 PARAMETERS 🦋

🌈 hContext

the handle of the context object. your lil entry pass into the whole situation 👑

🌈 capArea

a flag indicating the attribute to query. like, which thing are we asking about, bestie? 🎯

🌈 ulSubCapLength

the length (in bytes) of the rgbSubCap parameter. yes, in bytes, noted and memorized 📏

🌈 rgbSubCap

data indicating the attribute to query. the follow-up question to the question, iykyk 💬

🌈 pulRespDataLength

receives the length (in bytes) of the prgbRespData parameter. it's the lil envelope telling you how big the answer is gonna be ✉️

🌈 prgbRespData

on successful completion of the command, this parameter points to a buffer containing the actual data of the specified capability. the main character reveal, literally 🌟

---

💀 RETURN CODES 💀

Tspi_Context_GetCapability returns TSS_SUCCESS on success — slay — otherwise one of the following values gets returned:

• TSS_E_INVALID_HANDLE — hContext is an invalid handle. that handle is not it 🙈
• TSS_E_BAD_PARAMETER — one of the parameters did not match. mismatch behavior, embarrassing 😭
• TSS_E_INTERNAL_ERROR — an error occurred internal to the TSS. it's not you, it's the TSS having a moment 💀

---

👑 CONFORMING TO 👑

Tspi_Context_GetCapability conforms to the Trusted Computing Group Software Specification version 1.1 Golden. certified, official, iconic, periodt ⭐

---

🧚 SEE ALSO 🧚

(none).

nothing here bestie, you're on your own, but honestly you got this 🫶

---

and that's the whole page!! this one's from TSS 1.1, dated 2004-05-26 — vintage, but she still ate 💖✨🎀