IControlChangeNotify::OnNotify メソッド (devicetopology.h)

  • [アーティクル]

OnNotify メソッドは、コネクタまたはサブユニットの状態が変更されたときにクライアントに通知します。

構文

HRESULT OnNotify(
  [in] DWORD   dwSenderProcessId,
  [in] LPCGUID pguidEventContext
);

パラメーター

[in] dwSenderProcessId

コントロールの状態を変更したクライアントのプロセス ID。 ハードウェア イベントによって通知が生成された場合、このプロセス ID はクライアントのプロセス ID とは異なります。 詳細については、「解説」を参照してください。

[in] pguidEventContext

control-change イベントのコンテキスト GUID へのポインター。 コントロールの変更を開始するクライアントは、この GUID を提供します。 詳細については、「解説」を参照してください。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合はエラー コードを返します。

解説

クライアントは、このメソッドを使用して、他のプロセスとハードウェアによって行われた制御の変更を追跡できます。 ただし、コントロール設定を変更するクライアントは、通常、コントロールの変更によって生成される通知を無視できます。 OnNotify メソッドの実装では、クライアントは dwSenderProcessId パラメーターと pguidEventContext パラメーターを検査して、それがコントロール変更イベントのソースであるかどうかを検出できます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー devicetopology.h

こちらもご覧ください

IControlChangeNotify インターフェイス