Kernel Functions for Drivers            csxRequestSocketMask(9F)



NAME
     csxRequestSocketMask, csxReleaseSocketMask - set or  clear
     the client's client event mask

SYNOPSIS
     #include 



     int32t csxRequestSocketMask(clienthandlet ch,
          requestsocketmaskt *sm);


     int32t csxReleaseSocketMask(clienthandlet ch,
          releasesocketmaskt *rm);


INTERFACE LEVEL
     Solaris DI Specific (Solaris DI)

PARAMETERS
     ch    Client handle returned from csxRegisterClient(9F).


     sm    Pointer to a requestsocketmaskt structure.


     rm    Pointer to a releasesocketmaskt structure.


DESCRIPTION
     The  function  csxRequestSocketMask()  sets  the   client's
     client  event mask and enables the client to start receiving
     events at its event callback  handler.  Once  this  function
     returns  successfully, the client can start receiving events
     at its event callback handler. Any pending events  generated
     from the call to csxRegisterClient(9F) will be delivered to
     the client after this call as well. This allows  the  client
     to set up the event handler mutexes before the event handler
     gets called.


     csxRequestSocketMask()  must   be   used   before   calling
     csxGetEventMask(9F)  or csxSetEventMask(9F) for the client
     event mask for this socket.


     The function  csxReleaseSocketMask()  clears  the  client's
     client event mask.

STRUCTURE MEMBERS




SunOS 5.11          Last change: 19 Jul 1996                    1






Kernel Functions for Drivers            csxRequestSocketMask(9F)



     The structure members of requestsocketmaskt are:

        uint32t    Socket;       /* socket number */
         uint32t    EventMask;    /* event mask to set or return */



     The structure members of releasesocketmaskt are:

         uint32t    Socket;       /* socket number */



     The fields are defined as follows:

     Socket       Not used in Solaris, but for  portability  with
                  other  Card Services implementations, it should
                  be set to the logical socket number.


     EventMask    This field is bit-mapped.  Card  Services  per-
                  forms  event  notification based on this field.
                  See  csxeventhandler(9E)  for   valid   event
                  definitions   and  for  additional  information
                  about handling events.


RETURN VALUES
     CSUCES                 Successful operation.


     CSBADHANDLE              Client handle is invalid.


     CSINUSE                  csxReleaseSocketMask()  has  not
                                been done.


     CSBADSOCKET              csxRequestSocketMask()  has  not
                                been done.


     CSUNSUPORTEDFUNCTION    No PCMCIA hardware installed.


CONTEXT
     These functions may be called from user or kernel context.

SEE ALSO
     csxeventhandler(9E),                 csxGetEventMask(9F),
     csxRegisterClient(9F), csxSetEventMask(9F)




SunOS 5.11          Last change: 19 Jul 1996                    2






Kernel Functions for Drivers            csxRequestSocketMask(9F)



     PC Card 95 Standard, PCMCIA/JEIDA






















































SunOS 5.11          Last change: 19 Jul 1996                    3