Xilinx KCU105 User Manual page 97

Table D-1: APIs Provided by the XDMA Driver (Cont'd)
API Prototype
int xlnx_alloc_queues(
ps_pcie_dma_chann_desc
_t *ptr_chann_desc,
unsigned int
*ptr_data_q_addr_hi,
unsigned int
*ptr_data_q_addr_lo,
unsigned int
*ptr_sta_q_addr_hi,
unsigned int
*ptr_sta_q_addr_lo,
unsigned int
q_num_elements);
int xlnx_dealloc_queues(
ps_pcie_dma_chann_desc
_t *ptr_chann_desc)
PCIe Streaming Data Plane TRD
UG920 (v2017.1) June 01, 2017
Appendix D:
Details
Allocates
Source/Destination side
data and status queues.
Based on the direction of
the channel (specified
during the call to get the
DMA channel),
appropriate queues are
created.
De-allocates
source/destination side
data and status queues
www.xilinx.com
APIs Provided by the XDMA Driver in Linux
Parameters
ptr_chann_desc –
Channel descriptor
pointer acquired by an
earlier call to
xlnx_get_dma_channel.
ptr_data_q_addr_hi –
Pointer to a placeholder
for the upper 32 bits of
data queue address
ptr_data_q_addr_lo –
Pointer to a placeholder
for the lower 32 bits of
data queue address
ptr_sta_q_addr_hi –
Pointer to a placeholder
for the upper 32 bits of
status queue address
ptr_sta_q_addr_lo –
Pointer to a placeholder
for the lower 32 bits of
status queue address
q_num_elements –
Number of queue
elements requested. This
determines the number of
buffer descriptors.
ptr_chann_desc –
Channel descriptor
pointer
Return
Returns XLNX_SUCCESS
on success. On failure, a
negative value is returned.
Check "/* Xilinx DMA
driver status messages */"
in
ps_pcie_dma_driver.
h for more information on
error codes.
Returns XLNX_SUCCESS
on success. On failure, a
negative value is returned.
Check "/* Xilinx DMA
driver status messages */"
in
ps_pcie_dma_driver.
h for more information on
error codes.
97
Send Feedback