NAME

     ffi_prep_cif — Prepare a ffi_cif structure for use with ffi_call

SYNOPSIS

     #include <ffi.h>

     ffi_status
     ffi_prep_cif(ffi_cif *cif, ffi_abi abi, unsigned int nargs, ffi_type *rtype,
         ffi_type **atypes);

DESCRIPTION

     The ffi_prep_cif function prepares a ffi_cif structure for use with ffi_call abi specifies a
     set of calling conventions to use.  atypes is an array of nargs pointers to ffi_type structs
     that describe the data type, size and alignment of each argument.  rtype points to an
     ffi_type that describes the data type, size and alignment of the return value. Note that to
     call a variadic function ffi_prep_cif_var must be used instead.

RETURN VALUES

     Upon successful completion, ffi_prep_cif returns FFI_OK.  It will return FFI_BAD_TYPEDEF if
     cif is NULL or atypes or rtype is malformed. If abi does not refer to a valid ABI,
     FFI_BAD_ABI will be returned. Available ABIs are defined in <ffitarget.h>.

SEE ALSO

     ffi(3), ffi_call(3), ffi_prep_cif_var(3)

                                        February 15, 2008