IMiniportDMus::Metode init (dmusicks.h)

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

Penunjuk ke antarmuka IUnknown objek adaptor yang objek miniport-nya 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 penelepon 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.

Mengembalikan nilai

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 meminta Init 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 dipandu 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 driver miniport (ISR) ke daftar ISR. Ketika driver adaptor kemudian membebaskan objek port, driver port melepaskan referensinya ke objek IInterruptSync .

Parameter pUnknownAdapter dan pResourceList adalah nilai pointer yang sama dengan driver adaptor 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.

Persyaratan

   
Target Platform Desktop
Header dmusicks.h (termasuk Dmusicks.h)
IRQL PASSIVE_LEVEL

Lihat juga

IInterruptSync

IMiniportDMus

IPort::Init

IPortDMus

IPortDMus::Notify

IResourceList

IServiceGroup

PcNewInterruptSync