XAudio2 İşlem Kümeleri
Bu genel bakış, bir işlem kümesinin parçası olarak çağırabileceğiniz birkaç XAudio2 yöntemini tanıtır.
Çeşitli XAudio2 yöntemleri, OperationSet bağımsız değişkenini alır ve bu da ertelenmiş bir grubun parçası olarak çağrılmalarını sağlar. Belirli bir zamanda, IXAudio2::CommitChangesişlevini söz konusu grup için OperationSet tanımlayıcısıyla çağırarak bir dizi değişikliği aynı anda uygulayabilirsiniz. Tanımlayıcı rastgele bir sayıdır. Bu nedenle, istemci kodunun ayrı bölümlerinin herhangi bir çakışma olmadan grafiğe ayrı atomik değişiklikler uygulamasına izin verir. Önerilen uygulama, istemcinin benzersiz, yeni bir OperationSet tanımlayıcısı oluşturması gerektiğinde genel sayacı artırmasıdır. Grafikte atomik olarak uygulanan bir dizi değişikliğin örnek açısından doğru olması garanti edilir. Örneğin, sesler eşitlenmiş olarak başlar.
OperationSet XAUDIO2_COMMIT_NOW olarak ayarlarsanız, değişiklik hemen uygulanır. Yöntem çağrısından sonra ilk ses işleme geçişinde etkili olur. XAUDIO2_COMMIT_ALL ile CommitChanges çağırırsanız, OperationSet tanımlayıcılarından bağımsız olarak bekleyen tüm işlem kümelerinde değişiklikler gerçekleştirilir.
Bazı yöntemler, OperationSet XAUDIO2_COMMIT_NOW ile bir XAudio2 geri çağırmasından çağrıldıklarında hemen etkili olur. OperationSet bağımsız değişkenini alan diğer tüm yöntemler, yalnızca yöntem çağrıldıktan (XAUDIO2_COMMIT_NOW ile çağrılırsa) veya CommitChanges aynı OperationSetile çağrıldıktan sonra sonraki işlem geçişi üzerinde etkili olur. Bu nedenle, bazı yöntem çağrıları her zaman çağrıldıkları sırada gerçekleşmeyebilir.
Tüm bekleyen işlemler, IXAudio2::StopEngine çağrıldığında atomik olarak işlenir. Altyapı durdurulurken çağrılan tüm yöntemler, sağlanan OperationSet değerinden bağımsız olarak hemen geçerlilik kazanır. Altyapıyı yeniden başlattığınızda, XAudio2 zaman uyumsuz moda döner.
İşlem kümelerinin yararlı olduğu basit senaryolar aşağıdaki örnekleri içerir.
- Aynı anda birden çok ses başlatılıyor.
- Bir arabelleği bir sese aynı anda gönderme, ses parametrelerini ayarlama ve sesi başlatma.
- Tüm kaynak seslerini yeni bir alt sese bağlama gibi grafikte büyük ölçekli bir değişiklik yapma.
İşlem kümesi kullanma örneği için bkz. Nasıl yapılır: ses yöntemlerini İşlem Kümesi olarak gruplandırma.
İşlem Kümesi Yöntemleri
Bir işlem kümesinin parçası olarak aşağıdaki yöntemleri çağırabilirsiniz.
- IXAudio2SourceVoice::ExitLoop
- IXAudio2Voice::SetFilterParameters
- IXAudio2SourceVoice::SetFrequencyRatio
- IXAudio2Voice::D isableEffect
- IXAudio2Voice::EnableEffect
- IXAudio2Voice::SetChannelVolumes
- IXAudio2Voice::SetEffectParameters
- IXAudio2Voice::SetOutputMatrix
- IXAudio2Voice::SetVolume
- IXAudio2SourceVoice::Start
- IXAudio2SourceVoice::Stop
Daha önce açıklandığı gibi, istemci kodunun ertelenen değişiklikleri yürütmek için IXAudio2::CommitChangesişlevini çağırması gerekir.
İlgili konular