Fungsi IoCreateController (ntddk.h)

Artikel
02/26/2024

Rutinitas IoCreateController mengalokasikan memori untuk dan menginisialisasi objek pengontrol dengan ekstensi pengontrol dengan ukuran yang ditentukan driver.

Sintaks

PCONTROLLER_OBJECT IoCreateController(
  [in] ULONG Size
);

Parameter

[in] Size

Menentukan jumlah byte yang akan dialokasikan untuk ekstensi pengontrol.

Nilai kembali

IoCreateController mengembalikan pointer ke objek pengontrol atau penunjuk NULL jika memori tidak dapat dialokasikan untuk ekstensi perangkat yang diminta.

Keterangan

Objek pengontrol biasanya mewakili pengontrol perangkat fisik dengan perangkat yang terpasang di mana satu driver melakukan permintaan I/O. Ekstensi pengontrol dialokasikan dari kumpulan yang tidak dipagasi dan dijamin dapat diakses oleh rutinitas driver apa pun dan dalam konteks utas arbitrer.

Objek pengontrol digunakan untuk menyinkronkan operasi I/O ke perangkat target tempat permintaan I/O dapat masuk bersamaan ke satu driver monolitik. Driver juga dapat menggunakan objek pengontrol untuk menyinkronkan operasi melalui saluran perangkat.

Jika IoCreateController mengembalikan NULL, driver harus gagal memulai perangkat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Target Platform	Universal
Header	ntddk.h (termasuk Ntddk.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlIoPassive2(wdm), PowerIrpDDis(wdm)

Lihat juga