Konstanta DEVICE_STATE_XXX

Konstanta DEVICE_STATE_XXX menunjukkan status perangkat titik akhir audio saat ini.

Konstanta/nilai	Deskripsi
DEVICE_STATE_ACTIVE 0x00000001	Perangkat titik akhir audio aktif. Artinya, adaptor audio yang tersambung ke perangkat titik akhir ada dan diaktifkan. Selain itu, jika perangkat titik akhir dicolokkan ke jack pada adaptor, maka perangkat titik akhir dicolokkan.
DEVICE_STATE_DISABLED 0x00000002	Perangkat titik akhir audio dinonaktifkan. Pengguna telah menonaktifkan perangkat di panel kontrol multimedia Windows, Mmsys.cpl. Untuk informasi selengkapnya, lihat Keterangan.
DEVICE_STATE_NOTPRESENT 0x00000004	Perangkat titik akhir audio tidak ada karena adaptor audio yang tersambung ke perangkat titik akhir telah dihapus dari sistem, atau pengguna telah menonaktifkan perangkat adaptor di Pengelola Perangkat.
DEVICE_STATE_UNPLUGGED 0x00000008	Perangkat titik akhir audio dilepas. Adaptor audio yang berisi jack untuk perangkat titik akhir ada dan diaktifkan, tetapi perangkat titik akhir tidak dicolokkan ke jack. Hanya perangkat dengan deteksi jack-presence yang dapat berada dalam status ini. Untuk informasi selengkapnya tentang deteksi jack-presence, lihat Perangkat Titik Akhir Audio.
DEVICE_STATEMASK_ALL 0x0000000F	Menyertakan perangkat titik akhir audio di semua status aktif, dinonaktifkan, tidak ada, dan dilepas.

Keterangan

Metode IMMDeviceEnumerator::EnumAudioEndpoints, IMMDevice::GetState, dan IMMNotificationClient::OnDeviceStateChanged menggunakan konstanta DEVICE_STATE_XXX. Metode ini memungkinkan klien untuk mendapatkan informasi tentang perangkat titik akhir yang berada di salah satu status yang diwakili oleh konstanta DEVICE_STATE_XXX.

Namun, klien dapat membuka aliran (misalnya, dengan mendapatkan antarmuka IAudioClient untuk perangkat) hanya pada perangkat yang berada dalam status DEVICE_STATE_ACTIVE.

Panel kontrol multimedia Windows, Mmsys.cpl, menampilkan perangkat titik akhir audio dalam sistem. Menonaktifkan perangkat di Mmsys.cpl menyembunyikan perangkat dari mekanisme penemuan perangkat di API audio tingkat yang lebih tinggi, tetapi tidak membatalkan objek stream apa pun yang mungkin telah dibuat klien sebelum perangkat dinonaktifkan. Misalnya, jika streaming diputar di perangkat saat pengguna menonaktifkannya di Mmsys.cpl, aliran terus diputar tanpa gangguan.

Sebaliknya, menonaktifkan perangkat di Manajer Perangkat secara efektif menghapus perangkat dari sistem.

Untuk menggunakan Mmsys.cpl untuk melihat perangkat penyajian, buka jendela Prompt Perintah dan masukkan perintah berikut:

kontrol mmsys.cpl,,0

Untuk melihat perangkat pengambilan, masukkan perintah berikut:

mmsys.cpl kontrol,,1

Atau, Anda dapat melihat perangkat penyajian atau perangkat pengambilan di Mmsys.cpl dengan mengklik kanan ikon speaker di area pemberitahuan, yang terletak di sisi kanan taskbar, dan memilih Perangkat Pemutaran atau Perangkat Perekaman.

Mmsys.cpl selalu menampilkan perangkat titik akhir yang berada dalam status DEVICE_STATE_ACTIVE. Selain itu, dapat dikonfigurasi untuk menampilkan perangkat yang dinonaktifkan dan terputus.

Untuk melihat perangkat titik akhir yang berada di status DEVICE_STATE_DISABLED dan DEVICE_STATE_NOTPRESENT, klik kanan di jendela Mmsys.cpl dan pilih opsi Perlihatkan Perangkat yang Dinonaktifkan .

Untuk melihat perangkat titik akhir yang berada dalam status DEVICE_STATE_UNPLUGGED, klik kanan di jendela Mmsys.cpl dan pilih opsi Perlihatkan Perangkat yang Terputus .

Untuk melihat hanya perangkat titik akhir yang dalam status DEVICE_STATE_ACTIVE, batalkan pilihan opsi Tampilkan Perangkat yang Dinonaktifkan dan Tampilkan Perangkat yang Terputus .

Untuk mengaktifkan atau menonaktifkan perangkat titik akhir di Mmsys.cpl, klik Pemutaran atau Perekaman, bergantung pada apakah perangkat tersebut adalah perangkat pemutaran atau perekaman. Selanjutnya, pilih perangkat dan klik Properti. Di jendela Properti , di samping Penggunaan perangkat, pilih Gunakan perangkat ini (aktifkan) atau Jangan gunakan perangkat ini (nonaktifkan).

Persyaratan

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

Lihat juga

Konstanta Audio Inti

IMMDevice::GetState

Antarmuka IMMDeviceEnumerator

IMMDeviceEnumerator::EnumAudioEndpoints

IMMNotificationClient::OnDeviceStateChanged