Allocate Message-Signaled Interrupts (MSIs).
#include <zircon/syscalls.h> zx_status_t zx_msi_allocate(zx_handle_t handle, uint32_t count, zx_handle_t* out_allocation);
zx_msi_allocate() allocates a contiguous block of count MSIs and returns an
MSI allocation object in out_allocation for use with
This serves to allow a PCI device to request pre-allocation of MSI resources
for use in creating Interrupt objects corresponding to the device's interrupts.
The MSI allocation object is freed when handle is closed and no outstanding
handles to Interrupt objects created by
count must be 1, 2, 4, 8, 16, or 32.
handle must be a handle to the Root Resource, as such this syscall is intended for use only by the platform bus and Zircon coretests.
handle must have resource kind ZX_RSRC_KIND_ROOT.
zx_msi_allocate() returns ZX_OK on success. In the event of failure, a
negative error value is returned.
ZX_ERR_INVALID_ARGS count is not a valid value.
ZX_ERR_ACCESS_DENIED handle is not a Root Resource handle.
ZX_ERR_NOT_SUPPORTED MSIs are not supported by the platform.