acpi_nhlt_find_endpoint(9)

🌸 NAME 🌸

okay so bestie, welcome to the acpi_nhlt_find_endpoint(9) page from the Kernel API Manual 💖 this function is iconic for one reason:

acpi_nhlt_find_endpoint — Search all NHLT tables for an endpoint.

no cap, that's the mission 🎯

✨ SYNOPSIS ✨

Here's the exact summoning circle, character for character:

struct acpi_nhlt_endpoint * acpi_nhlt_find_endpoint (int link_type , int
       dev_type , int dir , int bus_id );

🎀 ARGUMENTS 🎀

• link_type — the hardware link type, e.g.: PDM or SSP. yes bestie, those are the vibes.
• dev_type — the device type. that's the whole descriptor.
• dir — stream direction. which way the stream is going, periodt.
• bus_id — the ID of virtual bus hosting the endpoint. it's literally the bus's name tag 🚌

🦋 DESCRIPTION 🦋

So here's the lowkey genius part: Either of link_type, dev_type, dir or bus_id may be set to a negative value to ignore the parameter during the search. negative = "not today, bestie" for that filter, and the search just moves on 💅

💅 RETURN 💅

A pointer to endpoint matching the criteria, NULL if not found or an ERR_PTR otherwise. vibe check: pointer, NULL, or ERR_PTR — that's the whole return situation, fr fr.

🔥 SEE ALSO 🔥

First up, the kernel file ./drivers/acpi/nhlt.c — go read it, iykyk 📖 then these function besties:

• acpi_nhlt_get_gbl_table(9)
• acpi_nhlt_put_gbl_table(9)
• acpi_nhlt_endpoint_match(9)
• acpi_nhlt_tb_find_endpoint(9)
• acpi_nhlt_endpoint_find_fmtcfg(9)
• acpi_nhlt_tb_find_fmtcfg(9)
• acpi_nhlt_find_fmtcfg(9)
• acpi_nhlt_endpoint_mic_count(9)

okay bye bestie 🫶 this page comes from ./drivers/acpi, dated October 2026, and it belongs to acpi_nhlt_find_endpoint(9) — slay 💅