Syntax:
PLX_STATUS
PlxPci_DmaChannelOpen(
PLX_DEVICE_OBJECT *pDevice,
U8 channel,
PLX_DMA_PROP *pDmaProp
);
PLX Chip Support:
9054, 9056, 9080, 9656, 8311, & 8000 DMA
Description:
Opens and initializes a DMA channel to prepare for later transfers.
打开并初始化一个DMA通道,为以后的传输做准备。
Starting with SDK 6.10, it is recommended to set the pDmaProp parameter to NULL and use other PLX APIs to retrieve and update DMA properties.
从sdk 6.10开始,建议将pdmapop参数设置为空,并使用其他plx API来检索和更新dma属性。
Refer to PlxPci_DmaGetProperties & PlxPci_DmaSetProperties.
参阅PlxPci_DmaGetProperties 和 PlxPci_DmaSetProperties.
Parameters:
pDevice
Pointer to an open device
channel
The number of the DMA channel to open
pDmaProp
Pointer to a structure containing the properties to use for initializing the DMA channel. If this NULL, the
DMA properties will not be modified.
Return Codes:
Code | Description |
ApiSuccess | The function returned successfully |
ApiNullParam | One or more parameters is NULL |
ApiInvalidDeviceInfo | The device object is not valid |
ApiPowerDown | The PLX device is in a power state that is lower than required for this function |
ApiDmaChannelInvalid | The DMA channel is not supported by the PLX chip |
ApiDmaChannelUnavailable | The DMA channel is in use by another process |
Usage:
// Open the DMA channel
PlxPci_DmaChannelOpen(
pDevice,
0, // Channel 0
NULL // Do not modify current DMA properties
);