dma_swstart(D3) dma_swstart(D3)
NAME
dma_swstart - initiate a DMA operation via software request
SYNOPSIS
#include <sys/types.h>
#include <sys/dma.h>
#include <sys/ddi.h>
void dma_swstart(struct dma_cb *dmacbptr, int chan, uchar_t mode);
Arguments
dmacbptr Pointer to a DMA command block specifying the DMA
operation.
chan Channel over which the operation is to take place.
mode Specifies whether the caller should sleep waiting
for the operation to complete.
DESCRIPTION
dma_swstart initiates a DMA operation previously programmed by
dma_swsetup(D3).
Return Values
None.
USAGE
If mode is set to DMA_NOSLEEP, then dma_swstart simply starts
the operation but does not wait for the operation to complete
and instead returns to the caller immediately. If mode is set
to DMA_SLEEP, then dma_swstart starts the operation and then
waits for the operation to complete, and returns to the caller
after the operation has finished.
The operation being initiated must have already been
programmed on the specified channel by dma_swsetup.
Level
Base only if mode is set to DMA_SLEEP.
Initialization, Base or Interrupt if mode is set to
DMA_NOSLEEP.
Synchronization Constraints
May sleep if mode is set to DMA_SLEEP.
Copyright 1994 Novell, Inc. Page 1
dma_swstart(D3) dma_swstart(D3)
Driver-defined basic locks, read/write locks, and sleep locks
may be held across calls to this function.
REFERENCES
dma_stop(D3), dma_swsetup(D3), dma_cb(D4)
NOTICES
Portability
AT-compatible architectures
Applicability
ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp
Future Directions
This interface is expected to be replaced or modified in a
future release.
Copyright 1994 Novell, Inc. Page 2