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

Voir aussi

IControlChangeNotify, interface