IMiniportDMus::Metode init (dmusicks.h)

Artikel
02/23/2024

Metode ini Init menginisialisasi objek miniport DMus.

Sintaks

NTSTATUS Init(
  [in, optional] PUNKNOWN      UnknownAdapter,
  [in]           PRESOURCELIST ResourceList,
  [in]           PPORTDMUS     Port,
  [out]          PSERVICEGROUP *ServiceGroup
);

Parameter

[in, optional] UnknownAdapter

Arahkan ke antarmuka IUnknown dari objek adaptor yang objek miniportnya sedang diinisialisasi. Parameter ini bersifat opsional dan dapat ditentukan sebagai NULL. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in] ResourceList

Penunjuk ke objek IResourceList yang berisi daftar sumber daya adaptor. Setelah meneruskan referensi ini ke driver miniport, driver port bebas untuk memeriksa konten daftar sumber daya tetapi tidak akan memodifikasi konten daftar ini.

[in] Port

Penunjuk ke objek IPortDMus yang menyediakan antarmuka panggilan balik driver port.

[out] ServiceGroup

Penunjuk output untuk grup layanan. Parameter ini menunjuk ke variabel pointer yang dialokasikan pemanggil tempat metode menulis pointer ke antarmuka IServiceGroup dari objek grup layanan driver miniport. Ini adalah grup layanan yang ingin digunakan driver miniport ini untuk panggilan ke IPortDMus::Notify.

Nilai kembali

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

Keterangan

Parameter pUnknownAdapter bersifat opsional:

Jika pUnknownAdapter bukan NULL, metode ini Init meminta objek pUnknownAdapter untuk antarmuka IInterruptSync-nya .
Jika pUnknownAdapter adalah NULL, Init metode memanggil PcNewInterruptSync untuk membuat objek IInterruptSync baru. Dalam hal ini, daftar sumber daya yang menunjuk pResourceList untuk memasok sumber daya interupsi yang digunakan objek IInterruptSync baru.

Dalam kedua kasus, Init metode dan memanggil metode RegisterServiceRoutine pada objek IInterruptSync untuk menambahkan rutinitas layanan interupsi (ISR) driver miniport ke daftar ISR. Ketika driver adaptor kemudian membebaskan objek port, driver port melepaskan referensinya ke objek IInterruptSync .

Parameter pUnknownAdapter dan pResourceList adalah nilai penunjuk yang sama dengan driver adapter yang sebelumnya diteruskan sebagai parameter ke metode objek InitIPortDMus (lihat IPort::Init).

Parameter pUnknownAdapter, pResourceList, pPort, dan ppServiceGroup mengikuti konvensi penghitungan referensi untuk objek COM.