IMiniportMidi::Metode init (portcls.h)

Artikel
08/07/2023

Metode ini Init menginisialisasi objek miniport MIDI.

Sintaks

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

Parameter

[in] 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 antarmuka IResourceList dari objek daftar sumber daya yang akan disediakan ke driver miniport selama inisialisasi. Setelah meneruskan referensi ini ke driver miniport, driver port bebas untuk memeriksa konten daftar sumber daya tetapi tidak akan memodifikasi konten daftar ini. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in] Port

Arahkan ke objek IPortMidi yang terikat ke objek miniport ini. Pemanggil menentukan nilai penunjuk non-NULL yang valid untuk parameter ini.

[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 sedang didaftarkan untuk pemberitahuan interupsi. Pemanggil menentukan nilai penunjuk non-NULL yang valid untuk parameter ini.

Mengembalikan nilai

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

Keterangan

Parameter UnknownAdapter bersifat opsional:

Jika UnknownAdapter bukan NULL, metode ini Init meminta objek UnknownAdapter untuk antarmuka IInterruptSync-nya .
Jika UnknownAdapterADALAH NULL, Init metode memanggil PcNewInterruptSync untuk membuat objek IInterruptSync baru. Dalam hal ini, daftar sumber daya yang menunjuk ResourceList 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 rutinitas sinkronisasi interupsi. Ketika driver adaptor kemudian membebaskan objek port, driver port melepaskan referensinya ke objek IInterruptSync .

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

Parameter UnknownAdapter, ResourceList, Port, dan ServiceGroup mengikuti konvensi penghitungan referensi untuk objek COM.