はじめに

バージョン1.0.16(LIBUSB_API_VERSION >= 0x01000102)は、一部のプラットフォームで活線挿抜イベントのサポートを追加しました(パラメーター LIBUSB_CAP_HAS_HOTPLUG を指定して libusb_has_capability() を呼び出し、あなたのプラットフォームが活線挿抜通知をサポートするかどうかをテストする必要があります)。

このインターフェイスを使用すると、一致するUSBデバイスの到着と出発の通知を要求できます。

活線挿抜通知を受信するには、 libusb_hotplug_register_callback() を呼び出してコールバックを登録します。この関数は、オプションで、 libusb_hotplug_deregister_callback() に渡すことができるコールバック・ハンドルを返します。

コールバック関数は、コールバックが追加のイベントを予期しているかどうかを示す整数(0または1)を返す必要があります。0を返すとコールバックが再度イベント待ちに入り、1を返すとコールバックの登録が解除されます。 LIBUSB_HOTPLUG_ENUMERATE フラグが原因で libusb_hotplug_register_callback() からコールバックが呼び出された場合、コールバックの戻り値は無視されることに注意してください。つまり、 libusb_hotplug_register_callback() から呼び出されたときに1を返すことによって、コールバックの登録を解除することはできません。

特定のコンテキストのコールバックは、 libusb_exit() によって自動的に登録解除されます。

1.0.16の時点で、サポートされている活線挿抜イベントは以下の2つです:

LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED: デバイスが装着済で使用する準備ができています
LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT: デバイスが取り去られて使用できなくなりました

活線挿抜イベントは、これらのイベントのいずれかまたは両方をリッスンできます。

注意: デバイスが取り去られたという通知を受け取った時、デバイスのlibusb_device_handlesがある場合は、各デバイス・ハンドルで libusb_close() を呼び出して、デバイスに関連付けられている残りのリソースを解放する必要があります。デバイスが取り去られると、そのデバイスに関連付けられているlibusb_device_handleは無効になり、後でそのデバイスが戻ってきても無効のままになります。

LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVEDイベントを処理する場合、libusb_deviceを受け取るlibusb関数を呼び出すのが安全であると見なされます。デバイスを開いて非同期転送を送信することも安全です。ただし、libusb_device_handleを使用する他のほとんどの関数は、安全に呼び出すことができません。このような関数の例としては、さまざまな USBデスクリプターを取得する同期API 関数またはブロッキング関数があります。これらの関数は、活線挿抜コールバックのコンテキスト外で使用する必要があります。

LIBUSB_HOTPLUG_EVENT_DEVICE_LEFTイベントを処理する場合、安全な関数は libusb_get_device_descriptor() のみです。

以下のコードは、活線挿抜インターフェイスの使用例を示しています:

#include <stdio.h>
#include <stdlib.h>
#include <time.h>
#include <libusb.h>
 
static int
count = 0;
 
int hotplug_callback(struct libusb_context
*ctx, struct libusb_device
*dev,
                     libusb_hotplug_event
event, void *user_data) {
  static libusb_device_handle
*dev_handle = NULL;
  struct libusb_device_descriptor
desc;
  int rc;
 
  (void)libusb_get_device_descriptor(dev,
&desc);
 
  if (LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED
== event) {
    rc = libusb_open(dev,
&dev_handle);
    if (LIBUSB_SUCCESS
!= rc) {
      printf("Could not open USB
device\n");
    }
  } else if
(LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT
== event) {
    if (dev_handle) {
      libusb_close(dev_handle);
      dev_handle = NULL;
    }
  } else {
    printf("Unhandled event %d\n",
event);
  }
  count++;
 
  return 0;
}
 
int main (void) {
  libusb_hotplug_callback_handle
callback_handle;
  int rc;
 
  libusb_init(NULL);
 
  rc = libusb_hotplug_register_callback(NULL,
LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED
|
                                        LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT,
0, 0x045a, 0x5005,
                                        LIBUSB_HOTPLUG_MATCH_ANY,
hotplug_callback, NULL,
                                        &callback_handle);
  if (LIBUSB_SUCCESS
!= rc) {
    printf("Error creating a hotplug
callback\n");
    libusb_exit(NULL);
    return EXIT_FAILURE;
  }
 
  while (count < 2) {
    libusb_handle_events_completed(NULL,
NULL);
    nanosleep(&(struct timespec){0,
10000000UL}, NULL);
  }
 
  libusb_hotplug_deregister_callback(NULL,
callback_handle);
  libusb_exit(NULL);
 
  return 0;
}