ddi_dma_numwin(9F)

NAME

     ddi_dma_numwin - retrieve number of DMA windows

SYNOPSIS

     #include <sys/ddi.h>
     #include <sys/sunddi.h>

     int ddi_dma_numwin(ddi_dma_handle_t handle, uint_t *nwinp);

PARAMETERS

     handle
           The  DMA handle previously  allocated  by  a  call  to
           ddi_dma_alloc_handle(9F).

     nwinp Upon a successful  return,   nwinp  will  contain  the
           number of  DMA windows for this object.

INTERFACE LEVEL

     Solaris DDI specific (Solaris DDI).

DESCRIPTION

     ddi_dma_numwin() returns the number of  DMA  windows  for  a
     DMA object if partial resource allocation was permitted.

RETURN VALUES

     ddi_dma_numwin() returns:

     DDI_SUCCESS
           Successfully filled in the number of  DMA windows.

     DDI_FAILURE
           DMA windows are not activated.

CONTEXT

     ddi_dma_numwin() can be called from user, kernel, or  inter-
     rupt context.

SEE ALSO

     ddi_dma_addr_bind_handle(9F),      ddi_dma_alloc_handle(9F),
     ddi_dma_buf_bind_handle(9F), ddi_dma_unbind_handle(9F)

     Writing Device Drivers