Fungsi XAudio2Buat (xaudio2.h)

Artikel
03/04/2024

Membuat objek XAudio2 baru dan mengembalikan penunjuk ke antarmuka IXAudio2-nya .

Sintaks

HRESULT XAudio2Create(
  [out] IXAudio2          **ppXAudio2,
  [in]  UINT32            Flags,
  [in]  XAUDIO2_PROCESSOR XAudio2Processor
);

Parameter

[out] ppXAudio2

Jika operasi berhasil, mengembalikan penunjuk ke objek IXAudio2 .

[in] Flags

Bendera yang menentukan perilaku objek IXAudio2 . Nilai parameter ini harus 0.

[in] XAudio2Processor

Nilai jenis XAUDIO2_PROCESSOR yang menentukan CPU mana yang akan digunakan. Jika beberapa bit ditentukan, sistem akan membuat utas pekerja terpisah untuk setiap prosesor.

XAUDIO2_PROCESSOR nilai default adalah XAUDIO2_DEFAULT_PROCESSOR.

Peringatan Jika Anda menentukan XAUDIO2_ANY_PROCESSOR, sistem akan menggunakan semua prosesor perangkat dan, seperti yang disebutkan di atas, buat utas pekerja untuk setiap prosesor.

Catatan Menentukan prosesor umumnya harus dihindari karena dapat mengganggu kemampuan penjadwal untuk menjadwalkan utas secara efektif di seluruh prosesor. Sebagai gantinya, teruskan nilai XAUDIO2_DEFAULT_PROCESSOR (lihat di bawah).

Nilai XAUDIO2_DEFAULT_PROCESSOR khusus menyebabkan XAudio2 menggunakan prosesor defaultnya.

Nilai kembali

Mengembalikan S_OK jika berhasil, kode kesalahan sebaliknya. Lihat Kode Kesalahan XAudio2 untuk deskripsi kode kesalahan spesifik XAudio2.

Keterangan

Versi DirectX SDK XAUDIO2 mendukung bendera XAUDIO2_DEBUG_ENGINE untuk memilih antara versi rilis dan 'dicentang'. Bendera ini tidak didukung atau ditentukan dalam versi XAUDIO2 Windows 8.

Catatan Tidak ada versi DirectX SDK yang berisi pustaka impor xaudio2.lib. Versi DirectX SDK menggunakan COM untuk membuat objek XAudio2 baru.

Persyaratan Platform

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Windows Phone 8.1: API ini didukung.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	xaudio2.h
Pustaka	Xaudio2.lib
DLL	Windows.Media.Audio.dll

Lihat juga

Cara: Membangun Grafik Pemrosesan Audio Dasar

Fungsi XAudio2

Share via