Registrando-se para notificação de alteração da interface do dispositivo

Um driver se registra para notificação de eventos de chegada e remoção da interface do dispositivo chamando IoRegisterPlugPlayNotification.

As informações a seguir se aplicam à chamada dessa rotina para notificação de alteração da interface do dispositivo:

• Especifique um EventCategory de EventCategoryDeviceInterfaceChange.

• EventCategoryData deve apontar para o GUID de uma classe de interface de dispositivo.

  O GUID para uma classe de interface é normalmente definido em um arquivo de cabeçalho com as estruturas, constantes e assim por diante, para a interface.

• Especifique um EventCategoryFlags de PNPNOTIFY_DEVICE_INTERFACE_INCLUDE_EXISTING_INTERFACES.

  Esse sinalizador direciona o gerenciador PnP a registrar o CallbackRoutine para futuras chegadas e partidas da interface do dispositivo da classe especificada e a chamar o CallbackRoutine imediatamente para quaisquer interfaces de dispositivo relevantes que já estejam ativas.

  Um driver pode chamar IoGetDeviceInterfaces para obter uma lista de interfaces existentes de uma classe específica e, em seguida, registrar sua rotina de retorno de chamada sem esse sinalizador, mas usar o sinalizador é mais fácil e evita um possível problema de temporização.

• Especifique um Contexto definido pelo driver, se apropriado, que o gestor PnP passará para a rotina de retorno de chamada.

Um driver que abre um identificador para um dispositivo em resposta a uma notificação de chegada da interface do dispositivo deve registar-se aos eventos EventCategoryTargetDeviceChange no dispositivo. (Veja Usando a notificação de alteração de dispositivo de destino PnP.)

Um driver cancela o registo de notificação chamando IoUnregisterPlugPlayNotification com o NotificationEntry retornado por IoRegisterPlugPlayNotification.