IAudioEffectsManager::GetAudioEffects メソッド (audioclient.h)

関連付けられているオーディオストリームのオーディオ効果の現在の一覧を取得します。

構文

HRESULT GetAudioEffects(
  AUDIO_EFFECT **effects,
  UINT32       *numEffects
);

effects

オーディオ効果の現在のリストを表す AUDIO_EFFECT 構造体の配列へのポインターを受け取ります。

numEffects

効果で返されるAUDIO_EFFECT構造体の数を受け取ります。

以下を含むがこれらに限定されない HRESULT を返します。

値	説明
S_OK	Success
AUDCLNT_E_DEVICE_INVALIDATED	関連付けられているオーディオストリームが破棄されました。

呼び出し元は、 CoTaskMemFree を使用して配列を解放する役割を担います。

オーディオ効果の一覧が変更されたときに通知を受け取る IAudioEffectsChangedNotificationClient を登録します。

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