STRUCT XHCI_DEVICE_CONTEXT_ARRAY(9)

💅 struct xhci_device_context_array(9) 💅

okay bestie, welcome to the Kernel API Manual — yes, that's the manual name, and yes, we're reading a struct page together, this is our bonding time 🫶

---

✨ NAME ✨

struct xhci_device_context_array — no description line, it just is. main character energy, honestly 👑

---

🌸 SYNOPSIS 🌸

struct xhci_device_context_array {
    __le64 *ctx_array;
    dma_addr_t dma;
 };

two members. that's it. that's the whole vibe check and it passed ✨

---

🎀 Members 🎀

• ctx_array — a pointer to an array of addresses, and the size of that array is not a fixed thing, it depends on Max Slots read from HCSPARAMS1. so like, it scales. we love a flexible icon 🦋
• dma — the DMA address that points at ctx_array. literally just the DMA address to ctx_array, no cap 💫

---

👑 Description 👑

This is the Device Context Base Address Array (DCBAA) — straight out of Section 6.1. very official. very cunty. here's the breakdown of the indexing, because the indices are doing different jobs and you will need to know which is which 🔥

• ctx_array[0] → Scratchpad Buffer Array Base Address
• ctx_array[1-MaxSlots] → Device Context Base Address

so slot zero is the scratchpad, and slots one through MaxSlots are the actual device context base addresses. that's the whole map, iykyk 🗺️💜

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/usb/host/xhci.h — go read it, it's giving lore

• struct xhci_cap_regs(9)
• struct xhci_op_regs(9)
• struct xhci_intr_reg(9)
• struct xhci_run_regs(9)
• struct xhci_container_ctx(9)
• struct xhci_slot_ctx(9)
• struct xhci_ep_ctx(9)

a whole friend group of structs, honestly. collect them all 🎀✨

---

and that's the page bestie!! it lives in ./drivers/usb/host, and this particular edition is dated October 2026 💖 go forth and read your xHCI structs, you're gonna slay 😭💅