Kernel Functions for Drivers                ddidmabufsetup(9F)



NAME
     ddidmabufsetup - easier DMA setup  for  use  with  buffer
     structures

SYNOPSIS
     #include 
     #include 



     int ddidmabufsetup(devinfot *dip, struct buf *bp, uintt flags,
          int (*waitfp) (caddrt),, caddrt arg, ddidmalimt *lim,
          ddidmahandlet *handlep);


INTERFACE LEVEL
     This  interface  is  obsolete.   ddidmabufbindhandle(9F)
     should be used instead.

PARAMETERS
     dip        A pointer to the device's devinfo structure.


     bp         A pointer  to  a  system  buffer  structure  (see
                buf(9S)).


     flags      Flags that go into a ddidmareq  structure  (see
                ddidmareq(9S)).


     waitfp     The address of a function to call back  later  if
                resources aren't available now. The special func-
                tion addresses DIDMASLEP and DIDMADONTWAIT
                (see  ddidmareq(9S)) are taken to mean, respec-
                tively, wait until resources are available, or do
                not wait at all and do not schedule a callback.


     arg        Argument to be passed to a callback function,  if
                such a function is specified.


     lim        A pointer to a DMA limits structure for this dev-
                ice       (see      ddidmalimsparc(9S)      or
                ddidmalimx86(9S)). If this pointer is NUL,  a
                default set of DMA limits is assumed.


     handlep    Pointer to a DMA  handle.  See  ddidmasetup(9F)
                for a discussion of handle.




SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                ddidmabufsetup(9F)



DESCRIPTION
     The  ddidmabufsetup()  function  is   an   interface   to
     ddidmasetup(9F).  It  uses  its  arguments to construct an
     appropriate ddidmareq structure and calls  ddidmasetup()
     with it.

RETURN VALUES
     See ddidmasetup(9F) for the  possible  return  values  for
     this function.

CONTEXT
     The ddidmabufsetup() function can be  called  from  user,
     interrupt,  or  kernel context, except when waitfp is set to
     DIDMASLEP, in which case it cannot be called from inter-
     rupt context.

ATRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Stability Level              Obsolete                    
    


SEE ALSO
     attributes(5),   ddidmaaddrsetup(9F),   ddidmafree(9F),
     ddidmahtoc(9F),    ddidmasetup(9F),    ddidmasync(9F),
     physio(9F),         buf(9S),          ddidmalimsparc(9S),
     ddidmalimx86(9S), ddidmareq(9S)


     Writing Device Drivers


















SunOS 5.11          Last change: 16 Jan 2006                    2