Fungsi IoDeleteController (ntddk.h)

  • Artikel

Rutinitas IoDeleteController menghapus objek pengontrol tertentu dari sistem, misalnya, ketika driver yang membuatnya sedang dibongkar.

Sintaks

void IoDeleteController(
  [in] PCONTROLLER_OBJECT ControllerObject
);

Parameter

[in] ControllerObject

Penunjuk ke objek pengontrol yang akan dilepaskan.

Nilai kembali

Tidak ada

Keterangan

IoDeleteController membatalkan alokasi memori untuk objek pengontrol, termasuk ekstensi pengontrol.

Rutinitas ini harus dipanggil ketika driver yang membuat objek pengontrol sedang dibongkar atau ketika driver mengalami kesalahan fatal selama start-up perangkat, seperti tidak dapat menginisialisasi perangkat fisik dengan benar.

Driver harus merilis sumber daya tertentu yang penyimpanan yang disediakan driver dalam ekstensi pengontrolnya sebelum memanggil IoDeleteController. Misalnya, jika driver menyimpan pointer ke objek interupsinya di ekstensi pengontrol, driver harus memanggil IoDisconnectInterrupt sebelum IoDeleteController.

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), IrqlIoPassive4(wdm), PowerIrpDDis(wdm)

Lihat juga

IoCreateController

IoDisconnectInterrupt