IPort::Metode init (portcls.h)

  • Artikel

Metode Init menginisialisasi driver port.

Sintaks

NTSTATUS Init(
  PVOID         DeviceObject,
  PVOID         Irp,
  PUNKNOWN      UnknownMiniport,
  PUNKNOWN      UnknownAdapter,
  PRESOURCELIST ResourceList
);

Parameter

DeviceObject

Penunjuk ke objek perangkat yang diteruskan sebagai argumen ke rutinitas startup perangkat driver adaptor. Objek perangkat adalah struktur sistem jenis DEVICE_OBJECT.

Irp

Pointer ke IRP yang diteruskan sebagai argumen ke rutinitas device-startup driver adapter.

UnknownMiniport

Arahkan ke antarmuka IUnknown dari objek miniport yang tidak diinisialisasi. Antarmuka ini dikueri untuk antarmuka miniport tertentu yang didukung oleh driver port, dan fungsi inisialisasi pada antarmuka tersebut dipanggil.

UnknownAdapter

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

ResourceList

Pointer ke objek IResourceList yang diteruskan sebagai argumen ke rutinitas device-startup driver adapter. Setelah meneruskan referensi ini ke driver miniport, driver port bebas untuk memeriksa konten daftar sumber daya tetapi tidak akan memodifikasi konten daftar ini.

Nilai kembali

Metode ini mengembalikan NTSTATUS yang berisi STATUS_SUCCESS jika panggilan berhasil. Jika tidak, metode mengembalikan kode kesalahan yang sesuai.

Keterangan

Objek miniport yang ditentukan oleh UnknownMiniport harus mendukung antarmuka miniport yang diperlukan driver port atau panggilan Init akan gagal.

Selama panggilan IPort::Init, driver port memanggil metode inisialisasi driver miniport (misalnya, lihat IMiniportWavePci::Init).

Parameter UnknownAdapter menunjuk ke antarmuka COM dari objek adaptor. Driver adaptor biasanya membuat objek ini dalam rutinitas startup perangkatnya, yang merupakan rutinitas yang dipanggil sistem operasi untuk memulai perangkat (lihat Urutan Startup). Untuk contoh antarmuka untuk objek adaptor, lihat CMiniportWaveRT::Init definisi dan implementasi dalam sampel driver audio sysvad.

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

Persyaratan

Persyaratan Nilai
Header portcls.h
IRQL PASSIVE_LEVEL

Lihat juga

IPort

IMiniportWavePci::Init