Metode IXAPO::LockForProcess (xapo.h)

Artikel
08/28/2023

Dipanggil oleh XAudio2 untuk mengunci konfigurasi input dan output dari XAPO yang memungkinkannya melakukan inisialisasi akhir sebelum Proses dipanggil pada utas realtime.

Sintaks

HRESULT LockForProcess(
  UINT32                               InputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pInputLockedParameters,
  UINT32                               OutputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pOutputLockedParameters
);

Parameter

InputLockedParameterCount

Jumlah elemen dalam ppInputLockedParameters. Harus berada dalam XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount dan XAPO_REGISTRATION_PROPERTIES. Nilai MaxInputBufferCount diteruskan ke CXAPOBase::CXAPOBase.

pInputLockedParameters

Array struktur XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS input. pInputLockedParameters mungkin NULL jika InputLockedParameterCount adalah 0, jika tidak, harus memiliki elemen InputLockedParameterCount .

OutputLockedParameterCount

Jumlah elemen dalam ppOutputLockedParameters. Harus berada dalam XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount dan XAPO_REGISTRATION_PROPERTIES. Nilai MaxOutputBufferCount diteruskan ke CXAPOBase::CXAPOBase. Jika bendera XAPO_FLAG_BUFFERCOUNT_MUST_MATCH ditentukan dalam XAPO_REGISTRATION_PROPERTIES. Bendera kemudian OutputLockedParameterCount harus sama dengan InputLockedParameterCount.

pOutputLockedParameters

Array output XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS struktur. pOutputLockedParameters mungkin NULL jika OutputLockedParameterCount adalah 0, jika tidak, harus memiliki elemen OutputLockedParameterCount .

Mengembalikan nilai

Mengembalikan S_OK jika berhasil, kode kesalahan sebaliknya.

Keterangan

Setelah dikunci, konfigurasi input dan output serta parameter terkunci lainnya tetap konstan hingga UnLockForProcess dipanggil. Setelah XAPO dikunci, panggilan lebih lanjut ke LockForProcess tidak berpengaruh sampai fungsi UnLockForProcess dipanggil.

XAPO menunjukkan format spesifik apa yang didukungnya melalui implementasi metode IsInputFormatSupported dan IsOutputFormatSupported . XAPO harus menegaskan konfigurasi input dan output didukung dan bahwa inisialisasi khusus efek yang diperlukan selesai. Metode IsInputFormatSupported, IsOutputFormatSupported, dan Initialize harus digunakan seperlunya sebelum memanggil metode ini.

Karena Proses adalah metode nonblocking, semua buffer memori internal yang diperlukan untuk Proses harus dialokasikan di LockForProcess.

Proses tidak pernah dipanggil sebelum LockForProcess berhasil dikembalikan.

LockForProcess dipanggil langsung oleh XAudio2 dan tidak boleh dipanggil oleh kode klien.

Persyaratan Platform

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

Persyaratan


Target Platform	Windows
Header	xapo.h

Lihat juga

IXAPO

Bagikan melalui