Проект OpenNet: MAN usb_register_hotplug_cbs (9) Ядро (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

usb_register_hotplug_cbs (9)

>> usb_register_hotplug_cbs (9) ( Solaris man: Ядро )

NAME

usb_register_hotplug_cbs, usb_unregister_hotplug_cbs - Register/unregister
for notification of device hotplug events

SYNOPSIS

#include <sys/usb/usba.h>



int usb_register_hotplug_cbs(dev_info_t *dip, 
    int (*disconnection_event_handler)(dev_info_t *dip,
    int (*reconnection_event_handler)(dev_info_t *dip);

 void usb_unregister_hotplug_cbs(dev_info_t *dip);

INTERFACE LEVEL

Solaris DDI specific (Solaris DDI)

PARAMETERS

For usb_register_hotplug_cbs()

dip

: Pointer to the device's dev_info structure.

disconnection_event_handler

: Called when device is disconnected. This handler takes a dev_info_t as an argument (representing the device being disconnected) and always returns USB_SUCCESS.

reconnection_event_handler

: Called when device is reconnected. This handler takes a dev_info_t as an argument (representing the device being reconnected) and always returns USB_SUCCESS.

For usb_unregister_hotplug_cbs():

dip

: Pointer to the device's dev_info structure.

DESCRIPTION

The usb_register_hotplug_cbs() function registers callbacks to be executed when the USB device represented by dip is hotplugged or removed.

The usb_unregister_hotplug_cbs() function unregisters or disengages callbacks from executing when the USB device represented by dip is hotplugged or removed.

RETURN VALUES

For usb_register_hotplug_cbs():

USB_SUCCESS

: Callbacks were successfully registered.

USB_FAILURE

: One or more arguments were NULL.
Callbacks could not be successfully registered.

For usb_unregister_hotplug_cbs(): None

CONTEXT

The usb_register_hotplug_cbs() function may be called only from attach(9E).

The usb_unregister_hotplug_cbs() function may be called only from detach(9E).

Registered callback handlers requiring the use of any DDI (section 9F) function (except ddi_taskq_* functions), should launch a separate thread using ddi_taskq_* routines for processing their event, to avoid deadlocks. The new thread can then safely call any DDI function it needs to handle the event.

The registered callback handlers execute in kernel context.

EXAMPLES

   
   int remove_device(dev_info_t *)
   {
           ...
           ...
           return (USB_SUCCESS);
   }

   int accommodate_device(dev_info_t *)
   {
           ...
           ...
           return (USB_SUCCESS);
   }

   if (usb_register_hotplug_cbs(
       dip, remove_device, accommodate_device) == USB_FAILURE) {
           cmn_err (CE_WARN,
               "%s%d: Could not register hotplug handlers.",
               ddi_driver_name(dip), ddi_get_instance(dip));
   }