Referensi DDI Perangkat Audio

Gambaran umum teknologi Referensi DDI Perangkat Audio.

Untuk mengembangkan Referensi DDI Perangkat Audio, Anda memerlukan header ini:

• audiomediatype.h
• audioenginebaseapo.h
• audioengineextensionapo.h
• baseaudioprocessingobject.h
• msapofxproxy.h

Untuk panduan pemrograman untuk teknologi ini, lihat:

• Referensi DDI Perangkat Audio

Enumerasi

APO_FLAG Enumerasi APO_FLAG mendefinisikan konstanta yang digunakan sebagai bendera oleh objek pemrosesan audio (APO).
APO_LOG_LEVEL Menentukan tingkat peristiwa APO yang dicatat dengan IAudioProcessingObjectLoggingService::ApoLog.
APO_NOTIFICATION_TYPE Menentukan jenis APO_NOTIFICATION.
APO_REFERENCE_STREAM_PROPERTIES Menentukan properti aliran loopback untuk metode panggilan balik IApoAcousticEchoCancellation2::GetDesiredReferenceStreamProperties.
AUDIO_SYSTEMEFFECT_STATE Menentukan status efek audio Objek Pemrosesan Audio Efek Sistem (sAPO).
DEVICE_ORIENTATION_TYPE Menentukan nilai orientasi perangkat untuk pemberitahuan jenis APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION.
KSPROPERTY_AUDIOEFFECTSDISCOVERY Enumerasi KSPROPERTY_AUDIOEFFECTSDISCOVERY mendefinisikan konstanta yang digunakan oleh daftar objek pemrosesan audio (API).

Fungsi

AcceptInput Memberikan input ke APO pada salah satu input tambahannya.
AddAuxiliaryInput Menambahkan input tambahan ke APO, dan menyediakan parameter inisialisasi.
AERT_Allocate Fungsi utilitas AERT_Allocate mengalokasikan dan mengunci segmen memori untuk digunakan oleh objek pemrosesan audio.
AERT_Free Fungsi utilitas AERT_Free merilis memori (bebas) yang dikunci oleh fungsi AERT_Allocate, untuk digunakan oleh objek pemrosesan audio untuk memproses data audio.
ApoLog Mencatat peristiwa APO.
APOProcess Metode APOProcess menyebabkan APO membuat lulus pemrosesan.
CalcInputFrames Metode CalcInputFrames mengembalikan jumlah bingkai input yang diperlukan APO untuk menghasilkan sejumlah bingkai output tertentu.
CalcOutputFrames Metode CalcOutputFrames mengembalikan jumlah bingkai output yang diperlukan APO untuk sejumlah bingkai input tertentu.
Menjalankan Setelah perubahan dilakukan, metode ini menyimpan perubahan.
CreateAudioMediaType Fungsi CreateAudioMediaType menggunakan format yang ditentukan oleh pemanggil untuk membuat objek jenis media yang menjelaskan format audio.
CreateAudioMediaTypeFromUncompressedAudioFormat Fungsi CreateAudioMediaTypeFromUncompressedAudioFormat menggunakan informasi yang disediakan dalam struktur UNCOMPRESSEDAUDIOFORMAT untuk membuat objek jenis media yang menjelaskan format audio.
GetApoNotificationRegistrationInfo Dipanggil oleh sistem untuk memungkinkan klien mendaftar menerima panggilan balik pemberitahuan untuk titik akhir APO dan pemberitahuan efek sistem.
GetApoNotificationRegistrationInfo2 Dipanggil oleh sistem untuk memungkinkan klien mendaftar menerima panggilan balik pemberitahuan untuk titik akhir APO dan pemberitahuan efek sistem. Metode ini menambahkan parameter yang dapat digunakan untuk menentukan jenis pemberitahuan yang didukung pada versi Windows yang berjalan pada perangkat saat ini.
GetAt Mendapatkan kunci properti dari array properti item.
GetAudioFormat Metode GetAudioFormat mengembalikan struktur WAVEFORMATEX untuk format data audio.
GetControllableSystemEffectsList Diimplementasikan oleh efek audio Objek Pemrosesan Audio Efek Sistem (sAPO) untuk memungkinkan pemanggil mendapatkan daftar efek saat ini.
GetCount Metode ini mengembalikan hitungan jumlah properti yang dilampirkan ke file.
GetDesiredReferenceStreamProperties Meminta sekumpulan properti untuk aliran loopback, jika didukung pada titik akhir audio terkait.
GetEffectsList Metode GetEffectsList digunakan untuk mengambil daftar efek pemrosesan audio yang saat ini aktif, dan menyimpan peristiwa yang akan disinyalkan jika daftar berubah.
GetFormat Metode GetFormat mengambil representasi IAudioMediaType dari format kustom.
GetFormatCount Metode GetFormatCount mengambil jumlah format kustom yang didukung oleh objek pemrosesan audio efek sistem (sAPO).
GetFormatRepresentation Metode GetFormatRepresentation mengambil representasi string dari format kustom sehingga dapat ditampilkan pada antarmuka pengguna.
GetInputChannelCount GetInputChannelCount mengembalikan jumlah saluran input (samples-per-frame) untuk APO ini.
GetLatency Metode GetLatency mengembalikan latensi untuk APO ini. Latensi adalah jumlah waktu yang diperlukan bingkai untuk melintasi lulus pemrosesan APO.
GetPreferredInputFormat Fungsi panggilan balik yang memungkinkan API menentukan format input pilihan untuk format output yang disediakan.
GetPreferredOutputFormat Fungsi panggilan balik yang memungkinkan API menentukan format output pilihan untuk format input yang disediakan.
GetRealTimeWorkQueue Mendapatkan ID antrean kerja yang dapat digunakan APO untuk menjadwalkan tugas yang perlu dijalankan pada prioritas real time.
GetRegistrationProperties GetRegistrationProperties mengembalikan properti pendaftaran objek pemrosesan audio (APO).
GetUncompressedAudioFormat IAudioMediaType::GetUncompressedAudioFormat mengembalikan informasi tentang format data audio.
GetValue Metode ini mengambil data untuk properti tertentu.
HandleNotification Dipanggil oleh sistem untuk memberi tahu klien tentang perubahan pada titik akhir APO atau efek sistem.
Initialize Metode Inisialisasi menginisialisasi APO dan mendukung data panjang variabel.
IsCompressedFormat Metode IsCompressedFormat menentukan apakah format data audio adalah format terkompresi.
IsEqual Metode IsEqual membandingkan dua jenis media dan menentukan apakah keduanya identik.
IsInputFormatSupported Memverifikasi bahwa format input tambahan tertentu didukung oleh APO.
IsInputFormatSupported Metode ini bernegosiasi dengan mesin audio Windows Vista untuk membuat format data untuk aliran data audio.
IsOutputFormatSupported Metode IsOutputFormatSupported digunakan untuk memverifikasi bahwa format output tertentu didukung.
LockForProcess Metode LockForProcess digunakan untuk memverifikasi bahwa APO dikunci dan siap memproses data.
RemoveAuxiliaryInput Menghapus input tambahan dari APO.
Atur ulang Metode Reset mengatur ulang APO ke keadaan semula. Metode ini tidak menyebabkan perubahan apa pun pada objek koneksi yang dilampirkan ke input atau output APO.
SetAudioDeviceModulesManager Dipanggil oleh sistem untuk meneruskan instans IAudioDeviceModulesManager ke Objek Pemrosesan Audio (API) yang mengimplementasikan antarmuka IAudioDeviceModulesClient .
SetAudioSystemEffectState Diimplementasikan oleh efek audio System Effects Audio Processing Object (sAPO) untuk memungkinkan pemanggil mengatur status efek.
SetValue Metode ini menetapkan nilai properti atau mengganti atau menghapus nilai yang ada.
UnlockForProcess Metode UnlockForProcess melepaskan kunci yang diberlakukan pada APO dengan metode LockForProcess.

Antarmuka

IApoAcousticEchoCancellation Antarmuka ini diimplementasikan oleh API untuk mengaktifkan skenario pembatalan gema akustik (AEC).
IApoAcousticEchoCancellation2 Memperluas IAcousticEchoCancellation untuk memungkinkan API menentukan properti aliran referensi yang diinginkan.
IApoAuxiliaryInputConfiguration Menyediakan metode yang dapat diterapkan API sehingga mesin audio dapat menambahkan dan menghapus aliran input tambahan.
IApoAuxiliaryInputRT Antarmuka realtime-safe yang digunakan untuk mendorong input tambahan APO.
IAudioDeviceModulesClient Objek Pemrosesan Audio (APO) mengimplementasikan antarmuka ini untuk mendapatkan referensi ke instans IAudioDeviceModulesManager .
IAudioMediaType Antarmuka IAudioMediaType mengekspos metode yang memungkinkan sAPO mendapatkan informasi yang digunakan untuk bernegosiasi dengan mesin audio untuk format data audio yang sesuai.
IAudioProcessingObject Objek Pemrosesan Audio Efek Sistem (sPO) biasanya digunakan dalam atau dipanggil dari utas proses real time.
IAudioProcessingObjectConfiguration Antarmuka IAudioProcessingObjectConfiguration digunakan untuk mengonfigurasi APO. Antarmuka ini menggunakan metodenya untuk mengunci dan membuka kunci APO untuk diproses.
IAudioProcessingObjectLoggingService Mewakili layanan pengelogan untuk API.
IAudioProcessingObjectNotifications Diimplementasikan oleh klien untuk mendaftar dan menerima pemberitahuan terkait audio umum untuk titik akhir APO dan pemberitahuan efek sistem.
IAudioProcessingObjectNotifications2 Diimplementasikan oleh klien untuk mendaftar dan menerima pemberitahuan terkait audio umum untuk titik akhir APO dan pemberitahuan efek sistem. Antarmuka ini menambahkan kemampuan untuk menentukan jenis pemberitahuan yang didukung pada versi Windows yang berjalan pada perangkat saat ini.
IAudioProcessingObjectPreferredFormatSupport Antarmuka ini diimplementasikan oleh API untuk memungkinkan mereka menentukan format input atau output pilihan.
IAudioProcessingObjectRT Antarmuka ini dapat beroperasi dalam mode real-time dan metodenya dapat disebut membentuk utas pemrosesan real-time.
IAudioProcessingObjectRTQueueService Mewakili layanan antrean kerja realtime untuk API.
IAudioSystemEffects Antarmuka IAudioSystemEffects menggunakan metode dasar yang diwarisi dari IUnknown, dan harus menerapkan metode Inisialisasi.
IAudioSystemEffects2 Antarmuka IAudioSystemEffects2 diperkenalkan dengan Windows 8.1 untuk mengambil informasi tentang objek pemrosesan dalam mode tertentu.
IAudioSystemEffects3 Diimplementasikan oleh klien yang memerlukan struktur APOInitSystemEffects3 untuk diteruskan ke metode IAudioProcessingObject::Initialize.
IAudioSystemEffectsCustomFormats Antarmuka IAudioSystemEffectsCustomFormats didukung di Windows Vista dan versi Windows yang lebih baru.
IPropertyStore Antarmuka ini mengekspos metode yang digunakan untuk menghitung dan memanipulasi nilai properti.

Struktur

AcousticEchoCanceller_Reference_Input Berisi informasi yang diperluas yang berkaitan dengan konfigurasi Pembatalan Gema Akustik (AEC) saat ini.
APO_NOTIFICATION Mewakili pemberitahuan untuk perubahan pada titik akhir APO atau efek sistem.
APO_NOTIFICATION_DESCRIPTOR Menentukan pemberitahuan APO yang diminta.
APO_REG_PROPERTIES Struktur APO_REG_PROPERTIES digunakan oleh IAudioProcessingObject::GetRegistrationProperties untuk mengembalikan properti pendaftaran objek pemrosesan audio (APO).
APOInitBaseStruct Struktur APOInitBaseStruct adalah header inisialisasi dasar yang harus mendahului data inisialisasi lainnya di IAudioProcessingObject::Initialize.
APOInitSystemEffects Struktur APOInitSystemEffects diteruskan ke APO efek sistem untuk inisialisasi.
APOInitSystemEffects2 Struktur APOInitSystemEffects2 diperkenalkan dengan Windows 8.1, untuk memungkinkan untuk memberikan konteks inisialisasi tambahan ke objek pemrosesan audio (APO) untuk inisialisasi.
APOInitSystemEffects3 Menyediakan parameter inisialisasi APO, memperluas APOInitSystemEffects2 untuk menambahkan kemampuan menentukan penyedia layanan untuk pengelogan.
AUDIO_ENDPOINT_PROPERTY_CHANGE_APO_NOTIFICATION_DESCRIPTOR Menentukan pemberitahuan APO perubahan properti titik akhir.
AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION Mewakili pemberitahuan APO perubahan properti.
AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR Menentukan pemberitahuan APO volume titik akhir.
AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION Mewakili pemberitahuan APO perubahan volume titik akhir audio.
AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 Mewakili pemberitahuan APO perubahan volume titik akhir audio. Ini adalah versi terbaru AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION yang menyediakan informasi tambahan tentang peristiwa perubahan volume.
AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION Mewakili pemberitahuan APO perubahan lingkungan audio.
AUDIO_MICROPHONE_BOOST_APO_NOTIFICATION_DESCRIPTOR Menentukan pemberitahuan APO peningkatan mikrofon titik akhir.
AUDIO_MICROPHONE_BOOST_NOTIFICATION Mewakili pemberitahuan APO peningkatan mikrofon audio.
AUDIO_SYSTEMEFFECT Mewakili efek audio Objek Pemrosesan Audio Efek Sistem (sAPO).
AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION Mewakili pemberitahuan APO efek audio sistem.
AUDIO_VOLUME_NOTIFICATION_DATA2 Mewakili informasi tentang peristiwa pemberitahuan perubahan volume. Struktur ini digunakan oleh struktur AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2.
KSP_PINMODE Struktur KSP_PINMODE menentukan properti pin dan mode pemrosesan audio yang didukung untuk pabrik pin.
MDEVICECAPSEX Struktur MDEVICECAPSEX berisi informasi kemampuan perangkat untuk driver perangkat Plug and Play (PnP).
MIDIOPENDESC Struktur MIDIOPENDESC adalah struktur yang diisi klien yang menyediakan informasi tentang cara membuka perangkat MIDI.
UNCOMPRESSEDAUDIOFORMAT Struktur UNCOMPRESSEDAUDIOFORMAT menentukan kecepatan bingkai, masker saluran, dan atribut lain dari format data audio yang tidak dikompresi.
WAVEFORMATEX Struktur WAVEFORMATEX menentukan format data aliran audio gelombang.