amdgpu_dm_cr..._cursor_mode(9)

💅 amdgpu_dm_cr..._cursor_mode(9) — a Kernel API Manual moment

okay so bestie, this is a page straight out of the Kernel API Manual (yes, that's the manual name, we're being fancy today 🎀), and the star of the show is amdgpu_dm_crtc_get_cursor_mode. Cursor drama incoming, iykyk.

---

✨ NAME ✨

amdgpu_dm_crtc_get_cursor_mode — literally just figuring out which cursor mode the crtc needs, no cap 💅

---

🌸 SYNOPSIS 🌸

int amdgpu_dm_crtc_get_cursor_mode (struct amdgpu_device *adev , struct
drm_atomic_commit *state , struct dm_crtc_state *dm_crtc_state , enum
amdgpu_dm_cursor_mode *cursor_mode );

---

🦋 ARGUMENTS 🦋

• adev — the amdgpu device itself, main character energy 💖
• state — the DRM atomic state
• dm_crtc_state — the amdgpu state for the CRTC that's holding the cursor (yes, the cursor lives there, we checked 🫶)
• cursor_mode — this one's the output: it returns the required cursor mode on dm_crtc_state

---

👑 DESCRIPTION 👑

So what this bad boy actually does: it gets whether the cursor should be enabled in native mode or overlay mode on the dm_crtc_state. Two modes, one vibe check, and it picks. 🌈

Here's the tea though — the cursor should be enabled in overlay mode if there exists an underlying plane (one the cursor may be blended on top of, bestie) that is any of these:

• YUV formatted 😳
• scaled differently from the cursor
• has a color pipeline active

Any one of those and it's overlay mode, periodt.

⚠️ little heads up: since zpos info is required, drm_atomic_normalize_zpos must be called before you call this function. Not optional, not a suggestion, it's giving prerequisite 💀

---

⭐ RETURN ⭐

0 on success 💖 — or an error code if getting the cursor plane state failed 😭 (rude of it, honestly).

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm_cursor.c
• Cursor Modes - Native vs Overlay(9)
• dm_plane_color_pipeline_active(9)

---

mmm okay that's the whole page, you ate that bestie 💜 this iconic little number came from ./drivers/gpu/drm/amd/display/..., dated October 2026, and titled amdgpu_dm_cr..._cursor_mode(9) — literally the manual's own signature sign-off, slay ✨🎀