Issue IM10: SceMi::BindMessageInPort() NULL binding argument

Subject: Issue IM10: SceMi::BindMessageInPort() NULL binding argument
From: Bojsen, Per (bojsen@zaiqtech.com)
Date: Tue Feb 24 2004 - 12:31:38 PST

Hi,

my action item from the last meeting was to propose changes to
the section describing the SceMi::BindMessageInPort() method
regarding the binding argument. I propose the following changes
to Section 5.3.3.4 "Message input port proxy binding":

  Change the declaration of the SceMi::BindMessageInPort()
  method as follows:

    SceMiMessageInPortProxy *
    SceMi::BindMessageInPort(
        const char *transactorName,
        const char *portName,
        const SceMiMessageInPortBinding *binding = NULL,
        SceMiEC *ec = NULL);

  [The change is to add NULL as a default value of the third
   argument, binding].

  [As part of the description of the binding argument, add the
   following:]

  If the binding argument is given as a NULL, the SCE-MI
  assumes that each of the Context, IsReady(), and Close() data
  members are have NULL values.

  [Add this NOTE for further clarification:]

  NOTE---This call

    inProxy = scemi->BindMessageInPort("Transactor",
                                       "Port");

  is equivalent to this code

    SceMiMessageInPortBinding inBinding;

    inBinding.Context = NULL;
    inBinding.IsReady = NULL;
    inBinding.Close = NULL;

    inProxy = scemi->BindMessageInPort("Transactor",
                                       "Port",
                                       &inBinding);

Note, the stuff in [brackets] are not part of the proposal.

Thanks,
Per

This archive was generated by hypermail 2b28 : Tue Feb 24 2004 - 12:36:05 PST