include/hw/stream.h

   1 #ifndef STREAM_H
   2 #define STREAM_H 1
   3
   4 #include "qemu-common.h"
   5 #include "qom/object.h"
   6
   7 /* stream slave. Used until qdev provides a generic way.  */
   8 #define TYPE_STREAM_SLAVE "stream-slave"
   9
  10 #define STREAM_SLAVE_CLASS(klass) \
  11      OBJECT_CLASS_CHECK(StreamSlaveClass, (klass), TYPE_STREAM_SLAVE)
  12 #define STREAM_SLAVE_GET_CLASS(obj) \
  13     OBJECT_GET_CLASS(StreamSlaveClass, (obj), TYPE_STREAM_SLAVE)
  14 #define STREAM_SLAVE(obj) \
  15      INTERFACE_CHECK(StreamSlave, (obj), TYPE_STREAM_SLAVE)
  16
  17 typedef struct StreamSlave {
  18     Object Parent;
  19 } StreamSlave;
  20
  21 typedef void (*StreamCanPushNotifyFn)(void *opaque);
  22
  23 typedef struct StreamSlaveClass {
  24     InterfaceClass parent;
  25     /**
  26      * can push - determine if a stream slave is capable of accepting at least
  27      * one byte of data. Returns false if cannot accept. If not implemented, the
  28      * slave is assumed to always be capable of recieveing.
  29      * @notify: Optional callback that the slave will call when the slave is
  30      * capable of recieving again. Only called if false is returned.
  31      * @notify_opaque: opaque data to pass to notify call.
  32      */
  33     bool (*can_push)(StreamSlave *obj, StreamCanPushNotifyFn notify,
  34                      void *notify_opaque);
  35     /**
  36      * push - push data to a Stream slave. The number of bytes pushed is
  37      * returned. If the slave short returns, the master must wait before trying
  38      * again, the slave may continue to just return 0 waiting for the vm time to
  39      * advance. The can_push() function can be used to trap the point in time
  40      * where the slave is ready to recieve again, otherwise polling on a QEMU
  41      * timer will work.
  42      * @obj: Stream slave to push to
  43      * @buf: Data to write
  44      * @len: Maximum number of bytes to write
  45      */
  46     size_t (*push)(StreamSlave *obj, unsigned char *buf, size_t len,
  47                                                     uint32_t *app);
  48 } StreamSlaveClass;
  49
  50 size_t
  51 stream_push(StreamSlave *sink, uint8_t *buf, size_t len, uint32_t *app);
  52
  53 bool
  54 stream_can_push(StreamSlave *sink, StreamCanPushNotifyFn notify,
  55                 void *notify_opaque);
  56
  57
  58 #endif /* STREAM_H */