IAcousticEchoCancellationControl

オーディオキャプチャエンドポイントが音響エコーキャンセレーション(AEC)をサポートしているかどうかを判定する仕組みを提供します。サポートしている場合、参照ストリームとして使用するオーディオレンダーエンドポイントをクライアントが設定できるようにします。

次の例は IAcousticEchoCancellationControl インターフェイスの使用方法を示しています。IAudioClient::GetService を呼び出し、IAcousticEchoCancellationControl インターフェイスの IID を渡します。成功した場合、そのキャプチャエンドポイントは AEC 用のループバック参照エンドポイントの制御をサポートしています。エンドポイントが AEC をサポートしていても、AEC 用のループバック参照エンドポイントの制御はサポートしていない場合がある点に注意してください。SetEchoCancellationRenderEndpoint を呼び出して AEC の参照ストリームを設定します。GetService の呼び出しが E_NOINTERFACE で失敗した場合、そのエンドポイント上の AEC エフェクト(サポートされている場合)は、ループバック参照エンドポイントの制御を許可していません。

wil::com_ptr_nothrow<IAudioClient> audioClient;

RETURN_IF_FAILED(device->Activate(_uuidof(IAudioClient), CLSCTX_INPROC_SERVER, nullptr, (void **)&audioClient));

// Call Initialize before calling GetService
// Implementation of IAudioClient::Initialize has been omitted from this sample for brevity.

RETURN_IF_FAILED(audioClient->Initialize(…));

// If the capture endpoint supports acoustic echo cancellation (AEC), pass it the endpoint id of the
// audio render endpoint that should be used as the reference stream. If the capture endpoint does not
// support AEC, the GetService call fails with E_NOINTERFACE, so errors from GetService are not
// treated as fatal.

wil::com_ptr_nothrow<IAcousticEchoCancellationControl> audioAcousticEchoCancellationControl;

if (SUCCEEDED(audioClient->GetService(IID_PPV_ARGS(&audioAcousticEchoCancellationControl))))
{

RETURN_IF_FAILED(audioAcousticEchoCancellationControl-> SetEchoCancellationRenderEndpoint(endpointIdOfReferenceAudioStream));

}

音響エコーキャンセレーション(AEC)の参照ストリームとして使用するオーディオレンダーエンドポイントを設定します。

次のものを含む HRESULT 値を返します:

次の例は IAcousticEchoCancellationControl インターフェイスの使用方法を示しています。IAudioClient::GetService を呼び出し、IAcousticEchoCancellationControl インターフェイスの IID を渡します。成功した場合、そのキャプチャエンドポイントは AEC 用のループバック参照エンドポイントの制御をサポートしています。エンドポイントが AEC をサポートしていても、AEC 用のループバック参照エンドポイントの制御はサポートしていない場合がある点に注意してください。SetEchoCancellationRenderEndpoint を呼び出して AEC の参照ストリームを設定します。GetService の呼び出しが E_NOINTERFACE で失敗した場合、そのエンドポイント上の AEC エフェクト(サポートされている場合)は、ループバック参照エンドポイントの制御を許可していません。

wil::com_ptr_nothrow<IAudioClient> audioClient;

RETURN_IF_FAILED(device->Activate(_uuidof(IAudioClient), CLSCTX_INPROC_SERVER, nullptr, (void **)&audioClient));

// Call Initialize before calling GetService
// Implementation of IAudioClient::Initialize has been omitted from this sample for brevity.

RETURN_IF_FAILED(audioClient->Initialize(…));

// If the capture endpoint supports acoustic echo cancellation (AEC), pass it the endpoint id of the
// audio render endpoint that should be used as the reference stream. If the capture endpoint does not
// support AEC, the GetService call fails with E_NOINTERFACE, so errors from GetService are not
// treated as fatal.

wil::com_ptr_nothrow<IAcousticEchoCancellationControl> audioAcousticEchoCancellationControl;

if (SUCCEEDED(audioClient->GetService(IID_PPV_ARGS(&audioAcousticEchoCancellationControl))))
{

RETURN_IF_FAILED(audioAcousticEchoCancellationControl-> SetEchoCancellationRenderEndpoint(endpointIdOfReferenceAudioStream));

}