IControlChangeNotify ::OnNotify, méthode (devicetopology.h)
La méthode OnNotify avertit le client lorsque le status d’un connecteur ou d’une sous-unité change.
Syntaxe
HRESULT OnNotify(
[in] DWORD dwSenderProcessId,
[in] LPCGUID pguidEventContext
);
Paramètres
[in] dwSenderProcessId
ID de processus du client qui a modifié l’état du contrôle. Si une notification est générée par un événement matériel, cet ID de processus diffère de l’ID de processus du client. Pour plus d'informations, consultez la section Notes.
[in] pguidEventContext
Pointeur vers le GUID de contexte pour l’événement control-change. Le client qui initie la modification de contrôle fournit ce GUID. Pour plus d'informations, consultez la section Notes.
Valeur retournée
Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.
Remarques
Un client peut utiliser cette méthode pour suivre les modifications de contrôle apportées par d’autres processus et par le matériel. Toutefois, un client qui modifie un paramètre de contrôle peut généralement ignorer la notification générée par la modification du contrôle. Dans son implémentation de la méthode OnNotify , un client peut inspecter les paramètres dwSenderProcessId et pguidEventContext pour déterminer si lui ou un autre client est la source de l’événement control-change.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | devicetopology.h |