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

Hi,

it occurred to me that the issue of a NULL binding argument also applies
to the SceMiMessageInPort::ReplaceBinding() method.

Hence, I propose the following additional changes to Section 5.3.6.2
"Replacing port binding":

  Change the declaration of the SceMiMessageInPortProxy::ReplaceBinding()
  method as follows:

    void
    SceMiMessageInPortProxy::ReplaceBinding(
        const SceMiMessageInPortBinding *binding = NULL,
        SceMiEC *ec = NULL);

  [The change is to add NULL as a default value of the first
   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 have NULL values.

  [Add this NOTE for further clarification:]

  NOTE---The ReplaceBinding() call below

    SceMiMessageInPortProxy *inProxy;

    // ...

    inProxy->ReplaceBinding();

  is equivalent to this code

    SceMiMessageInPortProxy *inProxy;

    // ...

    SceMiMessageInPortBinding inBinding;

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

    inProxy->ReplaceBinding(&inBinding);

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

Thanks,
Per
Received on Wed Mar 17 08:21:27 2004