Next: , Previous: bpipe_write_dpkt_n, Up: BPipe Manipulations   [Contents]


A.1.9 bpipe_write_dpkt

Write a data packet to a binary pipe output channel.

Synopsis

#include <bpipe/bpipe.h>

int bpipe_write_dpkt(
  BPipe *bpipe,
  void *buf,
  BPipeOutput *bpo
);

Parameters

BPipe *bpipe

the binary bpipe to which to write the packets

void *buf

a pointer to a user-provided memory buffer containing the data packets to be written

BPipeOutput *bpo

the output channel to which to write the packets.

Description

bpipe_write_dpkt writes a single data packet to a single binary pipe output channel. Contrast it with bpipe_write_dpkts and bpipe_write_dpkt_n. It must be called after a call to bpipe_write_hdr. It converts the packets’ core images into output images.

Returns

It returns zero upon success, non-zero upon failure. Upon failure bpipe_errno is set to BPEIOERR.