Registrando-se para notificação de alteração de dispositivo de destino

Um driver regista-se para ser notificado sobre eventos de alteração do dispositivo de destino PnP chamando IoRegisterPlugPlayNotification.

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

• Especifique um EventCategory de EventCategoryTargetDeviceChange.

• EventCategoryData deve apontar para o objeto de arquivo para o dispositivo no qual a notificação é solicitada.

  Se a rotina de retorno de chamada do driver requerer acesso ao objeto de ficheiro, o driver deverá obter uma referência no objeto de ficheiro antes de chamar IoRegisterPlugPlayNotification.

  Se a rotina de retorno de chamada do driver não exigir acesso ao objeto de arquivo, o driver não precisará fazer referência ao objeto.

  Depois que o objeto de arquivo é fechado, o driver continua a receber notificações para o dispositivo até que o driver remova seu registro de notificação. Este design permite que o condutor receba notificações dos eventos GUID_TARGET_DEVICE_REMOVE_CANCELLED, por exemplo.

• Especifique um Contexto definido pelo driver que o gestor PnP passará para a rotina de callback.

  Um driver pode usar o parâmetro Context para manter informações sobre o estado atual do objeto de arquivo (por exemplo, se ele foi fechado/excluído).

  Um driver também pode usar o contexto para armazenar o caminho usado para abrir originalmente o dispositivo. Um driver pode usar esse caminho para reabrir o dispositivo após uma operação de remoção cancelada. (Consulte Manipulando um evento GUID_TARGET_DEVICE_REMOVE_CANCELLED para obter mais informações.)

O driver remove um registo de notificação chamando IoUnregisterPlugPlayNotification com o NotificationEntry retornado por IoRegisterPlugPlayNotification. Se o controlador obteve uma referência no objeto de ficheiro quando se registou para a notificação e essa referência ainda está pendente, o controlador deve liberar a referência após remover a inscrição.