Registreren voor melding van wijziging van doelapparaat

Een stuurprogramma registreert zich voor meldingen van wijzigingen aan PnP-doelapparaten door de functie IoRegisterPlugPlayNotificationaan te roepen.

De volgende informatie is van toepassing op het aanroepen van deze routine voor melding over het wijzigen van het doelapparaat:

• Geef een EventCategory op voor EventCategoryTargetDeviceChange.

• EventCategoryData- moet verwijzen naar het bestandsobject voor het apparaat waarop een melding wordt aangevraagd.

  Als de terugbelroutine van het stuurprogramma toegang tot het bestandsobject vereist, moet het stuurprogramma een verwijzing naar het bestandsobject nemen voordat het IoRegisterPlugPlayNotificationaanroept.

  Als de callback-routine van het stuurprogramma geen toegang tot het bestandsobject vereist, hoeft het stuurprogramma niet naar het object te verwijzen.

  Nadat het bestandsobject is gesloten, blijft het stuurprogramma meldingen ontvangen voor het apparaat totdat het stuurprogramma de meldingsregistratie verwijdert. Met dit ontwerp kan het stuurprogramma bijvoorbeeld meldingen ontvangen van GUID_TARGET_DEVICE_REMOVE_CANCELLED gebeurtenissen.

• Geef een door het stuurprogramma gedefinieerde Context- op die de PnP-manager doorgeeft aan de callback-routine.

  Een stuurprogramma kan de parameter Context gebruiken om informatie over de huidige status van het bestandsobject te behouden (bijvoorbeeld is het gesloten/verwijderd).

  Een stuurprogramma kan ook de Context gebruiken om het pad op te slaan dat is gebruikt om het apparaat oorspronkelijk te openen. Een stuurprogramma kan dit pad gebruiken om het apparaat opnieuw te openen na een geannuleerde verwijderbewerking. (Zie voor meer informatie Het verwerken van een GUID_TARGET_DEVICE_REMOVE_CANCELLED-gebeurtenis.)

Een stuurprogramma verwijdert een meldingsregistratie door IoUnregisterPlugPlayNotification- aan te roepen met de NotificationEntry- geretourneerd door IoRegisterPlugPlayNotification. Als het stuurprogramma een referentie naar het bestandsobject heeft genomen toen het zich registreerde voor een melding en die referentie nog steeds geldig is, moet het stuurprogramma de referentie vrijgeven nadat het de registratie heeft verwijderd.