Metode IAudioProcessingObjectConfiguration::LockForProcess (audioenginebaseapo.h)

Artikel
02/28/2024

Metode LockForProcess ini digunakan untuk memverifikasi bahwa APO dikunci dan siap untuk memproses data.

Sintaks

HRESULT LockForProcess(
  [in] UINT32                    u32NumInputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppInputConnections,
  [in] UINT32                    u32NumOutputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppOutputConnections
);

Parameter

[in] u32NumInputConnections

Jumlah koneksi input yang dilampirkan ke APO ini.

[in] ppInputConnections

Deskriptor koneksi untuk setiap koneksi input yang dilampirkan ke APO ini.

[in] u32NumOutputConnections

Jumlah koneksi output yang dilampirkan ke APO ini.

[in] ppOutputConnections

Pendeskripsi koneksi untuk setiap koneksi output yang dilampirkan ke APO ini.

Nilai kembali

Metode mengembalikan LockForProcess nilai S_OK jika panggilan berhasil diselesaikan. Pada tahap ini, APO dikunci dan siap untuk memproses data.

Menampilkan kode	Deskripsi
E_POINTER	Penunjuk tidak valid diteruskan ke fungsi.
APOERR_INVALID_CONNECITON_FORMAT	Format koneksi tidak valid.
APOERR_NUM_CONNECTIONS_INVALID	Jumlah koneksi input atau output tidak valid pada APO ini.
APOERR_APO_LOCKED	APO sudah dikunci.
HRESULTS lainnya	Kegagalan ini akan dilacak oleh mesin audio.

Keterangan

Ketika metode dipanggil LockForProcess , pertama-tama melakukan pemeriksaan internal untuk melihat apakah APO telah diinisialisasi dan siap untuk memproses data. Setiap APO memiliki persyaratan inisialisasi yang berbeda sehingga setiap APO harus menentukan metode Inisialisasinya sendiri jika diperlukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dengan Windows Vista dan versi sistem operasi Windows yang lebih baru.
Target Platform	Universal
Header	audioenginebaseapo.h
Pustaka	Audioenginebaseapo.idl
IRQL	Semua tingkatan

Bagikan melalui