A DMA handle is an opaque object that is used as a reference to subsequently allocated DMA resources. The DMA handle is usually allocated in the driver's attach() entry point that uses ddi_dma_alloc_handle(9F). The ddi_dma_alloc_handle() function takes the device information that is referred to by dip and the device's DMA attributes described by a ddi_dma_attr(9S) structure as parameters. The ddi_dma_alloc_handle() function has the following syntax:
int ddi_dma_alloc_handle(dev_info_t *dip, ddi_dma_attr_t *attr, int (*callback)(caddr_t), caddr_t arg, ddi_dma_handle_t *handlep);
where:
Pointer to the device's dev_info structure.
Pointer to a ddi_dma_attr(9S) structure, as described in DMA Attributes.
Address of the callback function for handling resource allocation failures.
Argument to be passed to the callback function.
Pointer to a DMA handle to store the returned handle.