Index for Section 9

Alphabetical listing for P

Bottom of page

pcmcia_register_event_callback(9r)
NAME
  pcmcia_register_event_callback - PCMCIA: Registers an event callback
  interface

SYNOPSIS
  int pcmcia_register_event_callback(
	  int socket_number,
	  int event_number,
	  void (*function) (),
	  caddr_t argument );

ARGUMENTS
  socket_number
      Specifies the unique virtual socket number.  Typically, this argument
      is the socket_vnum member of the card_info structure pointer, which
      contains the unique virtual socket number.

  event_number
      Specifies the type of callback event. You can pass one of the following
      event callback constants defined in the /usr/sys/io/dec/pcmcia.h file:

      CARD_REMOVAL_EVENT
	  The event callback interface handles the removal of a PCMCIA card.

      CARD_INSERTION_EVENT
	  The event callback interface handles the insertion of a PCMCIA
	  card.

  function
      Specifies the event callback interface to register. You must implement
      this interface in the device driver.

  argument
      Specifies a driver-specific argument that you want the system to pass
      to the registered event callback interface. One example of a driver-
      specific argument is the driver's softc structure pointer.

DESCRIPTION
  The pcmcia_register_event_callback interface registers an event callback
  interface.

NOTES
  The pcmcia_register_event_callback interface is a jacket routine to the
  actual interfaces that perform the tasks of registering an event callback
  interface. You do not need to understand the details of these operations.

  Only device drivers that operate on the PCMCIA bus need to call the
  pcmcia_register_event_callback interface. Typically, you call this
  interface in the driver's probe interface.






RETURN VALUES
  The pcmcia_register_event_callback interface returns the following
  constants:

  PCMCIA_SUCCESS
      Successful completion.

  NULL
      The underlying kernel interfaces that register the event callback
      interface do not exist. The underlying kernel interfaces return
      PCMCIA_FAILURE if the unique virtual socket number argument
      (socket_number) is not valid or if there was not enough memory to
      allocate the required data structures.

Index for Section 9

Alphabetical listing for P

Top of page