IMiniportTopology::Metode init (portcls.h)

Artikel
02/26/2024

Metode ini Init menginisialisasi objek miniport topologi.

Sintaks

NTSTATUS Init(
  [in] PUNKNOWN      UnknownAdapter,
  [in] PRESOURCELIST ResourceList,
  [in] PPORTTOPOLOGY Port
);

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 IPortTopology yang terikat ke objek miniport ini. 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 dan ResourceList adalah nilai penunjuk yang sama dengan driver adapter yang sebelumnya diteruskan sebagai parameter ke metode Init objek IPortTopology (lihat IPort::Init).

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