Fungsi IoDeleteController (ntddk.h)
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) |