STRUCT XE_HW_ENGINE_SNAPSHOT(9)

💖 struct xe_hw_engine_snapshot — Hardware engine snapshot 💖

okay bestie, buckle up — this is the struct xe_hw_engine_snapshot page from the Kernel API Manual, and it's literally the receipt for everything the kernel remembers about a hardware engine ✨

---

🎀 NAME 🎀

struct xe_hw_engine_snapshot — Hardware engine snapshot. that's it, that's the vibe 🫶

---

🌸 SYNOPSIS 🌸

struct xe_hw_engine_snapshot {
    char *name;
    struct xe_hw_engine *hwe;
    u16 logical_instance;
    struct {
      enum xe_force_wake_domains domain;
      int ref;
    } forcewake;
    u32 mmio_base;
    bool kernel_reserved;
 };

like, look at her. main character struct energy 👑

---

🦋 Members 🦋

• name — the name of the hw engine ✨
• hwe — the hw engine itself, the whole point 💅
• logical_instance — the logical instance of this hw engine, so you know which one you're dealing with 🎀
• forcewake — a Force Wake information snapshot 🫶
  • forcewake.domain — the force wake domain of this hw engine 🔥
  • forcewake.ref — the Forcewake ref for the above domain, keyed to that domain, no cap ⭐
• mmio_base — the MMIO base address of this hw engine 🧚
• kernel_reserved — engine reserved, can't be used by userspace 💀 (yes it's a real bool, yes it means hands off)

---

🌈 Description 🌈

okay so the actual tea: this struct contains the snapshot of useful hardware engine info and registers 💖 that's the whole job. it's giving "little frozen polaroid of the engine's state," and honestly? obsessed 😭

---

💜 SEE ALSO 💜

• Kernel file ./drivers/gpu/drm/xe/xe_hw_engine_types.h struct xe_hw_engine_class_intf(9), struct xe_hw_engine(9) — go read these too bestie, iykyk 🌸

---

fr fr this one lives in ./drivers/gpu/drm/xe and the page is dated October 2026, under the Kernel API Manual banner — that's the source, the version and the date, all in one cute little sign-off 🎀✨💅 go slay your xe debugging era, mwah 🫶