Menggunakan Fungsi Penginstalan Perangkat
Bagian ini meringkas fungsi penginstalan perangkat. Dengan menggunakan fungsi penginstalan perangkat, perangkat lunak penginstalan dapat melakukan jenis operasi berikut:
Menginstal driver
Menangani kode DIF.
Mengelola set informasi perangkat.
Kelola daftar driver.
Mengelola antarmuka perangkat.
Kelola ikon dan bitmap lainnya.
Tabel berikut ini menyediakan ringkasan jenis fungsi berikut:
Handler Penginstalan Perangkat
Fungsi Kustomisasi Penginstalan Perangkat
Fungsi Properti Perangkat (Windows Vista dan Yang Lebih Baru)
Fungsi Penginstalan Driver
Menginstal paket driver tertentu yang telah diinstal sebelumnya di penyimpanan driver pada perangkat PnP yang ada dalam sistem. (Windows Vista dan versi Windows yang lebih baru) |
|
Mencopot pemasangan perangkat dan menghapus simpul perangkatnya (devnode) dari sistem. (Windows 7 dan versi Windows yang lebih baru) |
|
Menginstal paket driver di penyimpanan driver dan kemudian menginstal paket driver pada perangkat PnP yang cocok yang ada dalam sistem. (Windows Vista dan versi Windows yang lebih baru) |
|
Menghapus paket pengandar dari Penyimpanan Driver. (Windows 10 Versi 1703 dan versi Windows yang lebih baru) |
|
Updates paket driver yang diinstal untuk mencocokkan perangkat PnP yang ada dalam sistem. |
|
Gulung balik paket pengandar yang diinstal pada perangkat tertentu ke paket driver cadangan yang ditetapkan untuk perangkat. (Windows Vista dan versi Windows yang lebih baru) |
Fungsi Informasi Perangkat
Catatan
SetupApi tidak didukung pada semua edisi Windows. Jika memungkinkan, Anda harus menggunakan API lapisan bawah seperti yang tersedia melalui CfgMgr32.dll. Lihat Porting dari SetupApi ke CfgMgr32 untuk tips.
Membuat set informasi perangkat kosong. Set ini dapat dikaitkan dengan GUID kelas. |
|
Membuat set informasi perangkat kosong. Set ini dapat dikaitkan dengan GUID kelas dan dapat untuk perangkat pada komputer jarak jauh. |
|
Membuat elemen informasi perangkat baru dan menambahkannya sebagai anggota baru ke kumpulan informasi perangkat yang ditentukan. |
|
Mengambil informasi tentang instans perangkat yang ada dan menambahkannya ke kumpulan informasi perangkat yang ditentukan. |
|
Mengembalikan struktur konteks untuk elemen informasi perangkat dari kumpulan informasi perangkat. |
|
Mengambil ID instans perangkat yang terkait dengan elemen informasi perangkat. |
|
Mengambil GUID kelas yang terkait dengan kumpulan informasi perangkat jika memiliki kelas terkait. |
|
Mengambil informasi yang terkait dengan kumpulan informasi perangkat termasuk GUID kelas, handel komputer jarak jauh, dan nama komputer jarak jauh. |
|
Mengambil handel ke lembar properti dari elemen informasi perangkat tertentu atau kelas penyiapan perangkat dari kumpulan informasi perangkat tertentu. |
|
Mengembalikan kumpulan informasi perangkat yang berisi semua perangkat dari kelas tertentu. |
|
Mengembalikan kumpulan informasi perangkat yang berisi semua perangkat dari kelas tertentu pada komputer lokal atau jarak jauh. |
|
Mengatur elemen informasi perangkat yang ditentukan menjadi anggota set informasi perangkat yang saat ini dipilih. Fungsi ini biasanya digunakan oleh wizard penginstalan. |
|
Mengambil perangkat yang saat ini dipilih untuk set informasi perangkat yang ditentukan. |
|
Mendaftarkan instans perangkat yang baru dibuat dengan manajer Plug and Play. |
|
Menghapus anggota dari kumpulan informasi perangkat yang ditentukan. Fungsi ini tidak menghapus perangkat aktual. |
|
Menghancurkan set informasi perangkat dan membebaskan semua memori terkait. |
Fungsi Informasi Driver
Menyusun daftar driver yang terkait dengan instans perangkat tertentu atau dengan daftar driver kelas global set informasi perangkat. |
|
Menghitung anggota daftar informasi driver. |
|
Mengambil informasi terperinci untuk elemen informasi driver tertentu. |
|
Menyetel anggota yang ditentukan dari daftar pengandar sebagai pengandar terpilih saat ini. Ini juga dapat digunakan untuk mengatur ulang daftar driver sehingga tidak ada driver yang saat ini dipilih. |
|
Mengambil anggota daftar pengandar yang dipilih sebagai pengandar untuk diinstal. |
|
Membatalkan pencarian daftar driver yang saat ini sedang berlangsung di utas yang berbeda. |
|
Menghancurkan daftar informasi driver. |
Handler Penginstalan Perangkat
Memanggil alat penginstal kelas yang sesuai, dan penginstal bersama yang terdaftar, dengan permintaan penginstalan yang ditentukan. |
|
Handler default untuk permintaan DIF_PROPERTYCHANGE. Ini dapat digunakan untuk mengubah status perangkat yang diinstal. |
|
Mendaftarkan penginstal khusus perangkat yang tercantum dalam file INF untuk perangkat yang ditentukan. Fungsi ini adalah handler default untuk DIF_REGISTER_COINSTALLERS. |
|
Handler default untuk permintaan DIF_INSTALLDEVICE. |
|
Handler default untuk permintaan DIF_INSTALLDEVICEFILES. |
|
Handler default untuk permintaan DIF_INSTALLINTERFACES. Ini menginstal antarmuka yang tercantum dalam DDInstall. Bagian antarmuka dari file INF perangkat. |
|
Fungsi ini usang dan tidak dapat digunakan dalam versi Microsoft Windows apa pun. |
|
Handler default untuk permintaan DIF_REMOVEDEVICE. |
|
Handler default untuk permintaan DIF_UNREMOVE. |
|
Handler default untuk permintaan DIF_REGISTERDEVICE. |
|
Handler default untuk permintaan DIF_SELECTDEVICE. |
|
Handler default untuk permintaan DIF_SELECTBESTCOMPATDRV. |
|
Handler default untuk permintaan DIF_SELECTDEVICE. |
Fungsi Kustomisasi Penginstalan Perangkat
Mengambil parameter penginstalan kelas untuk set informasi perangkat atau elemen informasi perangkat tertentu. |
|
Mengatur atau menghapus parameter penginstalan kelas untuk kumpulan informasi perangkat atau elemen informasi perangkat tertentu. |
|
Mengambil parameter penginstalan perangkat untuk kumpulan informasi perangkat atau elemen informasi perangkat tertentu. |
|
Mengatur parameter penginstalan perangkat untuk kumpulan informasi perangkat atau elemen informasi perangkat tertentu. |
|
Mengambil parameter penginstalan untuk driver yang ditentukan. |
|
Mengatur parameter penginstalan untuk driver yang ditentukan. |
Menyiapkan Fungsi Kelas
Mengembalikan daftar GUID kelas penyiapan yang mencakup setiap kelas yang diinstal pada sistem. |
|
Mengembalikan daftar GUID kelas penyiapan yang mencakup setiap kelas yang diinstal pada sistem lokal atau sistem jarak jauh. |
|
Mengambil deskripsi kelas yang terkait dengan GUID kelas penyiapan yang ditentukan. |
|
Mengambil deskripsi kelas penyiapan yang diinstal pada komputer lokal atau jarak jauh. |
|
Mengambil kelas file INF perangkat tertentu. |
|
Mengambil GUID yang terkait dengan nama kelas yang ditentukan. Daftar ini dibuat berdasarkan kelas apa yang saat ini diinstal pada sistem. |
|
Mengambil GUID yang terkait dengan nama kelas yang ditentukan. Daftar yang dihasilkan ini berisi kelas yang saat ini terinstal pada komputer lokal atau jarak jauh. |
|
Mengambil nama kelas yang terkait dengan GUID kelas. |
|
Mengambil nama kelas yang terkait dengan GUID kelas. Kelas dapat diinstal pada komputer lokal atau jarak jauh. |
|
Menginstal bagian ClassInstall32 dari file INF yang ditentukan. |
|
Menginstal penginstal kelas atau kelas antarmuka. |
|
Membuka kunci registri kelas penyiapan perangkat , atau subkuntang tertentu dari kelas . |
|
Membuka kunci registri kelas penyiapan perangkat, kunci registri kelas antarmuka perangkat, atau subkuntang kelas tertentu. Fungsi ini membuka kunci yang ditentukan pada komputer lokal atau pada komputer jarak jauh. |
Fungsi Bitmap dan Ikon
Menyusun daftar gambar yang berisi bitmap untuk setiap kelas yang diinstal dan mengembalikan daftar dalam struktur data. |
|
Menyusun daftar gambar bitmap untuk setiap kelas yang diinstal pada komputer lokal atau jarak jauh. |
|
Mengambil indeks dalam daftar gambar kelas dari kelas tertentu. |
|
Mengambil indeks ikon mini yang disediakan untuk kelas yang ditentukan. |
|
Menggambar ikon mini yang ditentukan di lokasi yang diminta. |
|
Memuat ikon besar dan mini untuk kelas yang ditentukan. |
|
Memuat ikon perangkat untuk perangkat tertentu. (Windows Vista dan versi Windows yang lebih baru) |
|
Menghancurkan daftar gambar kelas. |
Fungsi Antarmuka Perangkat
Catatan
SetupApi tidak didukung pada semua edisi Windows. Jika memungkinkan, Anda harus menggunakan API lapisan bawah seperti yang tersedia melalui CfgMgr32.dll. Lihat Porting dari SetupApi ke CfgMgr32 untuk tips.
Mendaftarkan fungsionalitas perangkat (antarmuka perangkat) untuk perangkat. |
|
Mengambil informasi tentang antarmuka perangkat yang ada dan menambahkannya ke kumpulan informasi perangkat yang ditentukan. |
|
Mengembalikan alias antarmuka perangkat yang ditentukan. |
|
Mengembalikan kumpulan informasi perangkat yang berisi semua perangkat dari kelas tertentu. |
|
Mengembalikan kumpulan informasi perangkat yang berisi semua perangkat dari kelas tertentu di komputer lokal atau jarak jauh. |
|
Mengembalikan struktur konteks untuk elemen antarmuka perangkat dari kumpulan informasi perangkat. Setiap panggilan mengembalikan informasi tentang satu antarmuka perangkat. Fungsi ini dapat dipanggil berulang kali untuk mendapatkan informasi tentang beberapa antarmuka yang diekspos oleh satu atau beberapa perangkat. |
|
Mengembalikan detail tentang antarmuka perangkat tertentu. |
|
Membuat subkunci registri untuk menyimpan informasi tentang instans antarmuka perangkat dan mengembalikan handel ke kunci. |
|
Membuka subkuntang registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk instans antarmuka perangkat dan mengembalikan handel ke kunci. |
|
Menghapus subkunci registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk instans antarmuka perangkat. |
|
Adalah handler default untuk permintaan DIF_INSTALLINTERFACES. Ini menginstal antarmuka yang tercantum dalam DDInstall. Bagian antarmuka dari file INF perangkat. |
|
Menghapus antarmuka perangkat terdaftar dari sistem. |
|
Menghapus antarmuka perangkat dari kumpulan informasi perangkat. |
|
Mengatur antarmuka perangkat tertentu sebagai antarmuka default untuk kelas perangkat. |
|
Menginstal penginstal kelas atau kelas antarmuka. |
|
Membuka kunci registri kelas penyiapan perangkat , kunci registri kelas antarmuka perangkat, atau subkuntang tertentu dari kelas . Fungsi ini membuka kunci yang ditentukan pada komputer lokal atau pada komputer jarak jauh. |
Fungsi Properti Perangkat (Windows Vista dan Yang Lebih Baru)
Catatan
SetupApi tidak didukung pada semua edisi Windows. Jika memungkinkan, Anda harus menggunakan API lapisan bawah seperti yang tersedia melalui CfgMgr32.dll. Lihat Porting dari SetupApi ke CfgMgr32 untuk tips.
Mengambil properti perangkat yang diatur untuk kelas penyiapan perangkat atau kelas antarmuka perangkat. |
|
Mengambil properti kelas untuk kelas penyiapan perangkat atau kelas antarmuka perangkat di komputer lokal atau jarak jauh. |
|
Mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk kelas penyiapan perangkat atau kelas antarmuka perangkat. |
|
Mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk kelas penyiapan perangkat atau kelas antarmuka perangkat di komputer lokal atau jarak jauh. |
|
Mengambil properti perangkat yang diatur untuk antarmuka perangkat. |
|
Mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk antarmuka perangkat. |
|
Mengambil properti instans perangkat. |
|
Mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk instans perangkat. |
|
Mengatur properti kelas untuk kelas penyiapan perangkat atau kelas antarmuka perangkat. |
|
Mengatur properti perangkat untuk kelas penyiapan perangkat atau kelas antarmuka perangkat di komputer lokal atau jarak jauh. |
|
Mengatur properti perangkat dari antarmuka perangkat. |
|
Mengatur properti instans perangkat. |
Fungsi Registri
Catatan
SetupApi tidak didukung pada semua edisi Windows. Jika memungkinkan, Anda harus menggunakan API lapisan bawah seperti yang tersedia melalui CfgMgr32.dll. Lihat Porting dari SetupApi ke CfgMgr32 untuk tips.
Membuat kunci penyimpanan registri untuk informasi konfigurasi khusus perangkat dan mengembalikan handel ke kunci. |
|
Membuka kunci penyimpanan registri untuk informasi konfigurasi khusus perangkat dan mengembalikan handel ke kunci. |
|
Menghapus kunci registri yang dapat diakses pengguna yang ditentukan yang terkait dengan elemen informasi perangkat. |
|
Membuka kunci registri kelas penyiapan, atau subkuntang tertentu dari kelas . |
|
Membuka kunci registri kelas penyiapan perangkat, kunci registri kelas antarmuka perangkat, atau subkuntang tertentu dari kelas . Fungsi ini membuka kunci yang ditentukan pada komputer lokal atau pada komputer jarak jauh. |
|
Membuat subkunci registri nonvolatile untuk menyimpan informasi tentang instans antarmuka perangkat dan mengembalikan handel ke kunci. |
|
Membuka subkuntang registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk instans antarmuka perangkat dan mengembalikan handel ke kunci. |
|
Menghapus subkunci registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk instans antarmuka perangkat. |
|
Mengatur properti perangkat Plug and Play yang ditentukan. |
|
Mengambil properti perangkat Plug and Play yang ditentukan. |
|
Mengambil properti kelas perangkat tertentu dari registri. |
|
Mengatur properti kelas perangkat tertentu dalam registri. |
Fungsi Lainnya
Mengambil bagian Model INF berdekorasi yang sesuai untuk digunakan saat menginstal perangkat dari file INF perangkat. |
|
Mengambil bagian DDInstall yang sesuai untuk digunakan saat menginstal perangkat dari file INF perangkat. |
|
Mengambil nama bagian INF DDInstall yang menginstal perangkat untuk sistem operasi dan arsitektur prosesor tertentu. |
|
Mengambil nama ramah yang terkait dengan ID profil perangkat keras. |
|
Mengambil nama ramah yang terkait dengan ID profil perangkat keras pada komputer lokal atau jarak jauh. |
|
Mengambil daftar semua ID profil perangkat keras yang saat ini ditentukan. |
|
Mengambil daftar semua ID profil perangkat keras yang saat ini ditentukan pada komputer lokal atau jarak jauh. |
|
Memulai ulang perangkat tertentu atau, jika perlu, memulai semua perangkat yang dioperasikan oleh fungsi yang sama dan memfilter driver sebagai perangkat yang ditentukan. |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk