Metode IXAPO::LockForProcess (xapo.h)
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 |