UsbRegisterDeviceNotification

Description

Registers semaphores for attach/detach notification of specific USB devices.

Syntax

ulrc = UsbRegisterDeviceNotification(pNotifyID,hDeviceAdded,hDeviceRemoved,usVendor,usProduct,usBCDVersion)

Parameters

pNotifyID

the address of the variable to receive the Notification Identifier.

hDeviceAdded

the handle of the event semaphore to be posted on device attach.

hDeviceRemoved

the handle of the event semaphore to be posted on device detach.

usVendor

the Vendor Identifier (VendorID) from the device descriptor.

usProduct

the Product Identifier (ProductID) from the device descriptor.

usBCDVersion

the Device Release Number from the device descriptor.

Return Code

0x0000 - NO_ERROR

Errors

0x0000 - NO_ERROR
0x0006 - ERROR_INVALID_HANDLE
0x0057 - ERROR_INVALID_PARAMETER
0x005F - ERROR_INTERRUPT
0x0064 - ERROR_TOO_MANY_SEMAPHORES
0x0067 - ERROR_TOO_MANY_SEM_REQUESTS
0x0069 - ERROR_SEM_OWNER_DIED
0x1B58 - USB_NOT_INIT
0x1B59 - USB_ERROR_NO_MORE_NOTIFICATTIONS

Example Code

//Code Snippet - UsbRegisterDeviceNotification
{
  APIRET ulrc;
  HEV hDeviceAdded;
  HEV hDeviceRemoved;
  PHEV phDeviceAdded;
  PHEV phDeviceRemoved;
  PUSBNOTIFY pNotifyID;
  ULONG ulTimeout = 8000;
  USBNOTIFY NotifyID;
  USHORT usBCDVersion = 0x0101;
  USHORT usProduct = 0x602D;
  USHORT usVendor = 0x0C45;

  //acquire semaphores
  phDeviceAdded = &hDeviceAdded;
  ulrc = DosCreateEventSem(NULL,phDeviceAdded,DC_SEM_SHARED,FALSE);
  printf("\nDosCreateEventSem - ulrc: [%04X] (%hu)",ulrc,ulrc);
  phDeviceRemoved = &hDeviceRemoved;
  ulrc = DosCreateEventSem(NULL,phDeviceRemoved,DC_SEM_SHARED,FALSE);
  printf("\nDosCreateEventSem - ulrc: [%04X] (%hu)",ulrc,ulrc);

  pNotifyID = &NotifyID;
  ulrc = UsbRegisterDeviceNotification(pNotifyID,hDeviceAdded,hDeviceRemoved,usVendor,usProduct,usBCDVersion);
  printf("\nUsbRegisterDeviceNotification - ulrc: [%04X] (%hu)",ulrc,ulrc);

  //await attach device event
  ulrc = DosWaitEventSem(hDeviceAdded,ulTimeout);
  printf("\nDosWaitEventSem - ulrc: [%04X] (%hu)",ulrc,ulrc);
  if (!ulrc) //success
  {
    printf(" - obtained Attach Notification");
  }

  //await detach device event
  ulrc = DosWaitEventSem(hDeviceRemoved,ulTimeout);
  printf("\nDosWaitEventSem - ulrc: [%04X] (%hu)",ulrc,ulrc);
  if (!ulrc) //success
  {
    printf(" - obtained Detach Notification");
  }
}