Antarmuka IAllocatorMXF (dmusicks.h)

Antarmuka IAllocatorMXF mengelola penyimpanan buffer untuk aliran DirectMusic. Driver port DMus mengimplementasikan antarmuka ini dan mengeksposnya ke driver miniport DMus. Driver port DMus IAllocatorMXF membuat objek dan meneruskan pointer ke objek ini ke metode IMiniportDMus::NewStream driver miniport DMus. IAllocatorMXF mewarisi dari antarmuka IMXF .

IAllocatorMXF adalah antarmuka di mana driver miniport berkomunikasi dengan alokator internal driver port, yang mengalokasikan dan mengelola penggunaan kembali kumpulan struktur DMUS_KERNEL_EVENT . Setiap struktur dapat berisi peristiwa MIDI bertanda waktu.

Alokator juga mengabstraksi alokasi memori tambahan yang diperlukan untuk menyimpan peristiwa besar. Anggota uData dari DMUS_KERNEL_EVENT adalah serikat yang merupakan ukuran pointer: empat byte pada sistem 32-bit dan delapan byte pada sistem 64-bit. Jika data cukup kecil agar pas di ruang tersebut, maka uData akan berisi data MIDI aktual. Jika data untuk peristiwa tersebut lebih besar dari penunjuk 4 atau 8 byte, namun, anggota cbEvent menunjukkan fakta ini dan uData berisi pointer ke buffer alih-alih data MIDI aktual. Buffer ini dikelola oleh alokator dan merupakan ukuran konstan untuk setiap implementasi port-driver.

Warisan

Antarmuka IAllocatorMXF mewarisi dari antarmuka IUnknown . IAllocatorMXF juga memiliki jenis anggota ini:

Metode

Antarmuka IAllocatorMXF memiliki metode ini.

IAllocatorMXF::GetBuffer Metode GetBuffer mengalokasikan buffer untuk peristiwa MIDI yang panjang.
IAllocatorMXF::GetBufferSize Metode GetBufferSize mendapatkan ukuran buffer dari alokator.
IAllocatorMXF::GetMessage Metode GetMessage berfungsi sebagai titik pengambilan untuk komponen mode kernel DirectMusic apa pun yang menggunakan alokator driver port untuk menggunakan kembali struktur DMUS_KERNEL_EVENT.
IAllocatorMXF::P utBuffer Metode ini saat ini tidak digunakan oleh driver miniport. Metode PutBuffer meneruskan buffer ke alokator, tetapi ini terjadi secara otomatis ketika IMXF::P utMessage dipanggil pula.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	dmusicks.h