hv_pci_protocol_negotiation(9)

🦋 hv_pci_protocol_negotiation(9) 🦋

okay so welcome to the Kernel API Manual, bestie — this is the hv_pci_protocol_negotiation(9) page, and it's lowkey giving protocol negotiation main character energy. 💅✨

💖 NAME 💖

hv_pci_protocol_negotiation — Set up protocol

🌸 SYNOPSIS 🌸

int hv_pci_protocol_negotiation (struct hv_device *hdev , enum
       pci_protocol_version_t version[] , int num_version );

🎀 ARGUMENTS 🎀

• hdev — VMBus's tracking struct for this root PCI bus.
• version — Array of supported channel protocol versions in the order of probing - highest go first.
• num_version — Number of elements in the version array.

🔥 DESCRIPTION 🔥

Okay so this driver is intended to support running on Windows 10 (server) and later versions — periodt. 🪟✨

🚨 It will not run on earlier versions, because they assume that many of the operations which Linux needs accomplished with a spinlock held were done via asynchronous messaging via VMBus. No cap, that's the whole vibe. 💀

Windows 10 increases the surface area of PCI emulation so that these actions can take place by suspending a virtual processor for their duration. Iconic behavior, honestly. 🧚

This function negotiates the channel protocol version, failing if the host doesn't support the necessary protocol level. So yeah: protocol level or bust, bestie. 🫶

🌈 SEE ALSO 🌈

Kernel file ./drivers/pci/controller/pci-hyperv.c — that's the source file, and here's the whole SEE ALSO squad, fr fr:

• struct hv_msi_desc(9)
• struct hv_msi_desc2(9)
• struct tran_int_desc(9)
• hv_irq_retarget_interrupt(9)
• hv_pci_generic_compl(9)
• devfn_to_wslot(9)
• wslot_to_devfn(9)
• _hv_pcifront_read_config(9)
• _hv_pcifront_write_config(9)
• hv_pcifront_read_config(9)
• hv_pcifront_write_config(9)
• hv_pci_read_config_compl(9)
• hv_read_config_block(9)
• hv_pci_write_config_compl(9)
• hv_write_config_block(9)
• hv_register_block_invalidate(9)
• hv_msi_free(9)
• hv_compose_msi_msg(9)
• hv_pcie_init_irq_domain(9)
• get_bar_size(9)
• survey_child_resources(9)
• prepopulate_bars(9)
• create_root_hv_pci_bus(9)
• q_resource_requirements(9)
• new_pcichild_device(9)
• get_pcichild_wslot(9)
• pci_devices_present_work(9)
• hv_pci_start_relations_work(9)
• hv_pci_devices_present(9)
• hv_pci_devices_present2(9)
• hv_eject_device_work(9)
• hv_pci_eject_device(9)
• hv_pci_onchannelcallback(9)
• hv_pci_free_bridge_windows(9)
• hv_pci_allocate_bridge_windows(9)
• hv_allocate_config_window(9)
• hv_pci_enter_d0(9)
• hv_pci_query_relations(9)
• hv_send_resources_allocated(9)
• hv_send_resources_released(9)
• hv_pci_probe(9)
• hv_pci_remove(9)

🎀 that's the page, bestie — source/version: ./drivers/pci/controller, date: October 2026, page: hv_pci_protocol_negotiation(9). go off and negotiate that protocol 💖