ddi_dma_numwin(9F)

Name | Synopsis | Parameters | Interface Level | Description | Return Values | Context | See Also

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 interrupt 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

SunOS 5.10  Last Revised 29 Sep 1994

Name | Synopsis | Parameters | Interface Level | Description | Return Values | Context | See Also