xe_hwe_guc_logical_instance(9)

💅 NAME 💅

xe_hwe_guc_logical_instance — get the GuC-aligned logical instance of a hardware engine. this is the xe_hwe_guc_logical_instance(9) page from the Kernel API Manual, bestie 💖

✨ SYNOPSIS ✨

u16 xe_hwe_guc_logical_instance (struct xe_hw_engine *hwe );

🎀 ARGUMENTS 🎀

• hwe — Hardware engine. yes bestie, that's the engine we're asking about 🫶

🦋 DESCRIPTION 🦋

okay so for GuC backend usage, we should no longer use the raw logical instance directly. like, don't do it, bestie. this helper must be used to retrieve the logical instance of the hardware engine, and it takes care of any necessary adjustments — such as the GuC PAGING engine mapping 🎀

it's assumed to be used in conjunction with the GuC engine class. iykyk ✨

🔥 RETURN 🔥

the logical instance, taking into account stuff like GuC PAGING engine mapping. that's the vibe 💅

🌈 SEE ALSO 🌈

• Kernel file: ./drivers/gpu/drm/xe/xe_guc.c
• xe_guc_comm_init_early(9)
• xe_guc_init_post_hwconfig(9)
• xe_guc_min_load_for_hwconfig(9)
• xe_guc_softreset(9)
• xe_guc_runtime_suspend(9)
• xe_guc_runtime_resume(9)
• xe_guc_declare_wedged(9)
• xe_guc_using_main_gamctrl_queues(9)

okay that's the whole page, bestie 🫶 — source/version is ./drivers/gpu/drm/xe, dated October 2026, and the page is xe_hwe_guc_logical_instance(9). slay and bye 💖✨