IAcousticEchoCancellationControl::SetEchoCancellationRenderEndpoint method (audioclient.h)

Mengatur titik akhir render audio yang harus digunakan sebagai aliran referensi untuk pembatalan gema akustik (AEC).

Sintaks

HRESULT SetEchoCancellationRenderEndpoint(
  LPCWSTR endpointId
);

Parameter

endpointId

ID titik akhir titik akhir yang harus digunakan sebagai aliran referensi untuk AEC. Mengatur ID perangkat render yang tidak valid akan gagal dengan E_INVALIDARG. Mengatur nilai ke NULL akan menghasilkan Windows menggunakan algoritmanya sendiri untuk memilih perangkat referensi loopback

Nilai kembali

Mengembalikan nilai HRESULT termasuk yang berikut ini:

Nilai	Deskripsi
S_OK	Berhasil.
E_INVALIDARG	Nilai endpointId tidak valid.

Keterangan

Contoh berikut mengilustrasikan penggunaan antarmuka IAcousticEchoCancellationControl . Panggil IAudioClient::GetService, melewati IID untuk antarmuka IAcousticEchoCancellationControl . Jika berhasil, titik akhir pengambilan mendukung kontrol titik akhir referensi loopback untuk AEC. Perhatikan bahwa titik akhir dapat mendukung AEC, tetapi mungkin tidak mendukung kontrol titik akhir referensi loopback untuk AEC. Panggil SetEchoCancellationRenderEndpoint untuk mengatur aliran referensi untuk AEC. Jika panggilan ke GetService gagal dengan E_NOINTERFACE, efek AEC pada titik akhir (jika didukung), tidak mengizinkan kontrol atas titik akhir referensi loopback.

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));

}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Build 22621
Header	audioclient.h