Metode IPortDMus::RegisterServiceGroup (dmusicks.h)

Artikel
08/07/2023

Metode ini RegisterServiceGroup mendaftarkan grup layanan dengan driver port DMus.

Sintaks

void RegisterServiceGroup(
  [in] PSERVICEGROUP ServiceGroup
);

Parameter

[in] ServiceGroup

Penunjuk ke objek IServiceGroup . Ini adalah grup layanan yang akan didaftarkan.

Nilai kembali

Tidak ada

Keterangan

Driver miniport memanggil RegisterServiceGroup metode untuk mendaftarkan grup layanan (objek IServiceGroup ) dengan driver port. Driver port dapat menyisipkan satu atau beberapa sink layanannya (objek IServiceSink ) ke dalam grup layanan ini. Driver miniport mengirimkan pemberitahuan (dengan memanggil IPortDMus::Notify) ke grup layanan setiap kali terjadi gangguan. Setelah menerima pemberitahuan, grup layanan menjadwalkan panggilan prosedur yang ditangguhkan (DPC). DPC melakukan iterasi melalui semua sink layanan dalam grup layanan dan mengirim pemberitahuan ke masing-masing.

Driver miniport biasanya memanggil RegisterServiceSink selama eksekusi metode IMiniportDMus::Init . Tujuan dari panggilan ini adalah untuk mendaftarkan grup layanan dengan driver port cukup awal untuk mulai menangani gangguan segera setelah diaktifkan. Perhatikan bahwa grup layanan yang dihasilkan metode Init tidak tersedia untuk driver port sampai setelah pengembalian dari metode Init .

Jika driver miniport memanggil RegisterServiceSink, grup layanan yang diteruskan driver miniport ke RegisterServiceSink metode harus sama dengan yang dihasilkan driver miniport melalui metode Init-nya .

Driver miniport khas tidak perlu memanggil RegisterServiceSink lebih lanjut setelah pengembalian dari IMiniportDMus::Init telah terjadi.

Lihat contoh driver audio DMusUART di Microsoft Windows Driver Kit (WDK) untuk contoh kode yang menunjukkan bagaimana driver miniport memanggil RegisterServiceSink dari dalam metode IMiniportDMus::Init .

Parameter pServiceGroup mengikuti konvensi penghitungan referensi untuk objek COM.