IAudioProcessingObjectNotifications::HandleNotification メソッド (audioengineextensionapo.h)

APO エンドポイントまたはシステム効果への変更をクライアントに通知するために、システムによって呼び出されます。

構文

void HandleNotification(
  APO_NOTIFICATION *apoNotification
);

パラメーター

apoNotification

通知に関連付けられている APO の変更を表す APO_NOTIFICATION 。

戻り値

なし

解説

IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo を実装して、このメソッドが呼び出される APO 変更のセットを指定します。

このメソッドは、 LockForProcess が呼び出された後に呼び出され、 UnlockForProcess の前に呼び出されなくなります。 実行中の通知がある場合は、 UnlockForProcess の実行中または後に実行される可能性があります。 この場合、APO は同期を処理する必要があります。

注意

HandleNotification メソッドは、いずれかのプロパティが変更されたときにのみ呼び出されるため、API は各プロパティに対して 1 回クエリを実行して初期値を取得する必要があります。 これに対する例外は、APO がAPO_NOTIFICATION_TYPE_ENDPOINT_VOLUMEに登録されたときの初期オーディオ エンドポイント ボリュームと、APO が APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE に登録する場合の PKEY_AudioEndpoint_Disable_SysFx の値です。

オーディオ ドライバーに付属できるオーディオ処理オブジェクト (API) のWindows 11 API の詳細については、「Windows 11 API for Audio Processing Objects」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows ビルド 22000
Header	audioengineextensionapo.h