Bagikan melalui

fungsi auxGetDevCapsW (mmeapi.h)

  • Artikel

Fungsi auxGetDevCaps mengambil kemampuan perangkat output tambahan tertentu.

Sintaksis

MMRESULT auxGetDevCapsW(
  UINT_PTR   uDeviceID,
  LPAUXCAPSW pac,
  UINT       cbac
);

Parameter

uDeviceID

Pengidentifikasi perangkat output tambahan yang akan dikueri. Tentukan pengidentifikasi perangkat yang valid (lihat bagian komentar berikut), atau gunakan konstanta berikut:

Nilai Arti
AUX_MAPPER Pemeta audio tambahan. Fungsi mengembalikan kesalahan jika tidak ada pemeta audio tambahan yang diinstal.

pac

Arahkan ke struktur AUXCAPS untuk diisi dengan informasi tentang kemampuan perangkat.

cbac

Ukuran, dalam byte, dari struktur AUXCAPS .

Mengembalikan nilai

Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Kemungkinan nilai kesalahan termasuk yang berikut ini.

Mengembalikan kode Deskripsi
MMSYSERR_BADDEVICEID
 Pengidentifikasi perangkat yang ditentukan berada di luar rentang.

Komentar

Pengidentifikasi perangkat di uDeviceID bervariasi dari nol hingga satu kurang dari jumlah perangkat yang ada. AUX_MAPPER juga dapat digunakan. Gunakan fungsi auxGetNumDevs untuk menentukan jumlah perangkat output tambahan yang ada dalam sistem.

Nota

Header mmeapi.h mendefinisikan auxGetDevCaps sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Platform Target Windows
Header mmeapi.h (termasuk Windows.h)
Pustaka Winmm.lib
DLL Winmm.dll

Lihat juga

Audio Waveform

Waveform Functions