Metode IAllocatorMXF::GetMessage (dmusicks.h)

Metode ini GetMessage berfungsi sebagai titik pengambilan untuk komponen mode kernel DirectMusic yang menggunakan alokator driver port untuk menggunakan kembali struktur DMUS_KERNEL_EVENT .

Sintaks

NTSTATUS GetMessage(
  [out] PDMUS_KERNEL_EVENT *ppDMKEvt
);

Parameter

[out] ppDMKEvt

Penunjuk output untuk peristiwa MIDI. Parameter ini menunjuk ke variabel pointer yang dialokasikan penelepon tempat metode menulis pointer ke struktur peristiwa yang diambil dari alokator. Struktur itu sendiri kosong (di-nol oleh alokator).

Nilai kembali

GetMessage mengembalikan S_OK jika panggilan berhasil. Jika tidak, metode mengembalikan kode kesalahan yang sesuai.

Keterangan

Driver miniport menggunakan GetMessage metode untuk mengambil struktur peristiwa untuk penyajian dan pengambilan MIDI. Metode ini mengambil struktur DMUS_KERNEL_EVENT dari kumpulan yang sama dengan IMXF::P utMessage menempatkannya ke dalam ketika membuangnya ke alokator.

Dalam kasus aliran penangkapan MIDI, driver port mengambil peristiwa pengambilan dari driver miniport ketika diminta oleh DPC Layanan biasa.

Untuk informasi selengkapnya tentang alokator, lihat Alokator.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	dmusicks.h (termasuk Dmusicks.h)
IRQL	<=DISPATCH_LEVEL

Lihat juga

DMUS_KERNEL_EVENT

IAllocatorMXF

IMXF::P utMessage