Metode IAudioInputSelector::SetSelection (devicetopology.h)

  • Artikel

Metode SetSelection memilih salah satu input pemilih input.

Sintaks

HRESULT SetSelection(
  [in] UINT    nIdSelect,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] nIdSelect

Input pemilih baru. Pemanggil harus mengatur parameter ini ke ID lokal bagian yang memiliki tautan langsung ke salah satu input pemilih.

[in] pguidEventContext

Nilai konteks untuk metode IControlChangeNotify::OnNotify . Parameter ini menunjuk ke GUID konteks peristiwa. Jika panggilan SetSelection mengubah status kontrol pemilih input, semua klien yang telah mendaftarkan antarmuka IControlChangeNotify dengan kontrol tersebut menerima pemberitahuan. Dalam implementasi metode OnNotify , klien dapat memeriksa GUID konteks peristiwa untuk menemukan apakah itu atau klien lain adalah sumber peristiwa perubahan kontrol. Jika penelepon menyediakan penunjuk NULL untuk parameter ini, metode pemberitahuan klien menerima penunjuk konteks NULL .

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode Deskripsi
E_INVALIDARG
 Parameter nIdSelect bukan ID lokal bagian pada input pemilih.
E_OUTOFMEMORY
 Kehabisan memori.

Keterangan

ID lokal adalah angka yang secara unik mengidentifikasi bagian di antara semua bagian dalam topologi perangkat. Untuk mendapatkan ID lokal suatu bagian, panggil metode IPart::GetLocalId pada objek bagian.

Untuk contoh kode yang memanggil metode SetSelection , lihat implementasi fungsi SelectCaptureDevice di Topologi Perangkat.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header devicetopology.h

Lihat juga

Antarmuka IAudioInputSelector

IPart::GetLocalId