IControlChangeNotify::OnNotify 方法 (devicetopology.h)
当连接器或子单元的状态发生更改时, OnNotify 方法会通知客户端。
语法
HRESULT OnNotify(
[in] DWORD dwSenderProcessId,
[in] LPCGUID pguidEventContext
);
参数
[in] dwSenderProcessId
更改控件状态的客户端的进程 ID。 如果通知由硬件事件生成,则此进程 ID 将不同于客户端的进程 ID。 有关详细信息,请参阅“备注”。
[in] pguidEventContext
指向控件更改事件的上下文 GUID 的指针。 启动控件更改的客户端提供此 GUID。 有关详细信息,请参阅“备注”。
返回值
如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。
注解
客户端可以使用此方法跟踪其他进程和硬件所做的控制更改。 但是,更改控件设置的客户端通常可以忽略控件更改生成的通知。 在 OnNotify 方法的实现中,客户端可以检查 dwSenderProcessId 和 pguidEventContext 参数,以发现它还是另一个客户端是 control-change 事件的源。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | devicetopology.h |