dwc2_hcd_qh_free_ddma(9)

💖 dwc2_hcd_qh_free_ddma — the Kernel API Manual page you've been waiting for 💖

okay so bestie, this is a page from the Kernel API Manual and honestly? it's a little cleanup queen moment. she's not the one doing the allocating, she's the one doing the freeing. very "you had your turn, now pack it up" energy. 🎀

---

✨ NAME ✨

dwc2_hcd_qh_free_ddma — frees a QH structure's Descriptor DMA related members. that's it, that's the job. she takes out the Descriptor-DMA trash and she does it thoroughly. 🧹💅

---

🌸 SYNOPSIS 🌸

void dwc2_hcd_qh_free_ddma (struct dwc2_hsotg *hsotg , struct dwc2_qh *qh );

void, no return value, no notes, she just does the thing and leaves. main character energy fr fr. ✨

---

🦋 ARGUMENTS 🦋

• hsotg — The HCD state structure for the DWC OTG controller. like, the whole big picture state of the controller, the context, the vibes. 👑
• qh — The QH to free. this is the actual one getting freed, the little guy we're saying bye to. 🥺

---

💜 DESCRIPTION 💜

okay so here's the tea: this function frees the descriptor list memory associated with the QH. that memory? gone. released. not your problem anymore. 😌

and here's the extra lil detail that i need you to not miss: if the QH is periodic and it's the last one, then she also frees the FrameList memory and disables periodic scheduling. so she's not just doing a one-and-done — she's lowkey checking the conditions first. conditional queen behavior. 🧚✨

real talk though: this is teardown code, so if you're calling it you should actually know what's still holding on to qh. free the wrong thing and it's giving 💀 — undefined behavior doesn't do vibes checks, she just crashes.

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/usb/dwc2/hcd_ddma.c — that's where the girlies live, go read it iykyk 📖
• dwc2_hcd_qh_init_ddma(9) — the setup counterpart, the ~before~ to this ~after~ 🫶
• dwc2_hcd_start_xfer_ddma(9) — starting the transfer
• dwc2_hcd_complete_xfer_ddma(9) — finishing the transfer

---

🍓 sign-off 🍓

and that's the page!! from ./drivers/usb/dwc2, dated October 2026 — so like, future-dated queen. 💖 go free your QH, bestie, and slay responsibly. ✨🎀💅