IAudioVolumeDuckNotification

IAudioVolumeDuckNotification インターフェイスは、ストリーム減衰の変化に関する通知をシステムが送信するために使用されます。ストリーム減衰(ダッキング)は Windows 7 で導入された機能で、新しい通信ストリームが開かれたときに、システムが通信用でないストリームの音量を調整するものです。この機能の詳細については、「Default Ducking Experience」を参照してください。

アプリケーションがシステムによる減衰動作をオプトアウトする必要がある場合は、IAudioSessionControl2::SetDuckingPreference を呼び出し、その設定を指定する必要があります。

他の WASAPI インターフェイスが WASAPI システムコンポーネントによって実装されているのとは異なり、IAudioVolumeDuckNotification インターフェイスは、カスタムのストリーム減衰動作を提供するためにアプリケーション側で実装します。イベント通知を受け取るには、アプリケーションが IAudioSessionManager2::RegisterDuckNotification メソッドに、アプリケーションが実装した IAudioVolumeDuckNotification へのポインターを渡します。

アプリケーションが IAudioVolumeDuckNotification インターフェイスを登録すると、セッションマネージャーはダッキング通知を送信する必要が生じたときに IAudioVolumeDuckNotification の実装を呼び出します。アプリケーションは、インターフェイスのメソッドを介したコールバックの形式でイベント通知を受け取ります。

アプリケーションが通知を受け取る必要がなくなったら、IAudioSessionManager2::UnregisterDuckNotification メソッドを呼び出します。UnregisterDuckNotification メソッドは、アプリケーションが以前に登録した IAudioVolumeDuckNotification インターフェイスの登録を解除します。

アプリケーションは、イベントコールバックの実行中に通知コールバックの登録または登録解除を行ってはなりません。

詳細については、「Implementation Considerations for Ducking Notifications」を参照してください。

例

次のサンプルコードは、IAudioVolumeDuckNotification インターフェイスの実装例を示しています。

class CDuckNotification : public IAudioVolumeDuckNotification
{
    LONG            _Cref;
    HWND            m_hwndMain;

    CDuckNotification (HWND hWnd) : 
        _Cref(1), 
        m_hwndMain (hWnd)
                             {}

    
    HRESULT OnVolumeDuckNotification (LPCWSTR SessionID, UINT32 CommunicationSessionCount)
    {
         PostMessage(m_hwndMain, WM_VOLUME_DUCK, 0, 0);
         return S_OK;
    }
    HRESULT OnVolumeUnduckNotification (LPCWSTR SessionID)
    {
         PostMessage(m_hwndMain, WM_VOLUME_UNDUCK, 0, 0);
         return S_OK;
    }

protected:
    ~CDuckNotification() {}

public:
    HRESULT QueryInterface (REFIID Iid, void** ReturnValue)
    {
        if (ReturnValue == NULL)
        {
            return E_POINTER;
        }
        *ReturnValue = NULL;
        if (iid == IID_IUnknown)
        {
            *ReturnValue = static_cast<IUnknown *>(static_cast<IAudioVolumeDuckNotification *>(this));
            AddRef();
        }
        else if (iid == __uuidof(IAudioVolumeDuckNotification))
        {
            *ReturnValue = static_cast<IAudioVolumeDuckNotification *>(this);
            AddRef();
        }
        else
        {
            return E_NOINTERFACE;
        }
        return S_OK;
    }
    ULONG AddRef()
    {
        return InterlockedIncrement(&_Cref);
    }

    ULONG Release()
    {
        LONG ref = InterlockedDecrement(&_Cref);
        if (ref == 0)
        {
            delete this;
        }
        return 0;
    }
};

OnVolumeDuckNotification メソッドは、システムによる保留中のダッキングイベントに関する通知を送信します。

メソッドが成功した場合は S_OK を返します。

アプリケーションが IAudioVolumeDuckNotification インターフェイスの実装を IAudioSessionManager2::RegisterDuckNotification を呼び出して登録した後、セッションマネージャーはダッキングの開始に関する通知を送信したいときに OnVolumeDuckNotification を呼び出します。アプリケーションはコールバックの形式でイベント通知を受け取ります。

OnVolumeUnduckNotification メソッドは、システムによる保留中のアンダッキングイベントに関する通知を送信します。

メソッドが成功した場合は S_OK を返します。

アプリケーションが IAudioVolumeDuckNotification インターフェイスの実装を IAudioSessionManager2::RegisterDuckNotification を呼び出して登録した後、セッションマネージャーはダッキングの終了に関する通知を送信したいときに OnVolumeUnduckNotification を呼び出します。アプリケーションはコールバックの形式でイベント通知を受け取ります。