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.

• Mengelola daftar driver.

• Mengelola antarmuka perangkat.

• Kelola ikon dan bitmap lainnya.

Tabel berikut ini menyediakan ringkasan jenis fungsi berikut:

Fungsi Penginstalan Driver

Fungsi Informasi Perangkat

Fungsi Informasi Pengemudi

Handler Penginstalan Perangkat

Fungsi Kustomisasi Penginstalan Perangkat

Fungsi Pengaturan Kelas

Fungsi Bitmap dan Ikon

Fungsi Antarmuka Perangkat

Fungsi Properti Perangkat (Windows Vista dan Versi Terbaru)

Fungsi Registri

Fungsi Lain

Fungsi Penginstalan Driver

DiInstallDevice	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)
DiUninstallDevice	Menghapus pemasangan perangkat dan menghapus simpul perangkatnya (devnode) dari sistem. (Windows 7 dan versi Windows yang lebih baru)
DiInstallDriver	Melakukan pra-instalasi paket driver di penyimpanan driver dan kemudian menginstal paket driver tersebut pada perangkat PnP yang cocok yang ada dalam sistem. (Windows Vista dan versi Windows yang lebih baru)
DiUninstallDriver	Menghapus paket pengemudi dari Penyimpanan Driver. (Windows 10 Versi 1703 dan versi Windows yang lebih baru)
PerbaruiPengandarUntukPerangkatPlugAndPlay	Memperbarui paket driver yang diinstal untuk mencocokkan perangkat PnP yang ada dalam sistem.
DiRollbackDriver	Gulung balik paket driver yang diinstal pada perangkat tertentu ke paket driver cadangan yang ditetapkan untuk perangkat. (Windows Vista dan versi Windows yang lebih baru)

Fungsi Informasi Perangkat

Nota

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.

SetupDiCreateDeviceInfoList	Membuat kumpulan informasi perangkat kosong. Set ini dapat dihubungkan dengan GUID kelas.
SetupDiCreateDeviceInfoListEx	Membuat set informasi perangkat kosong. Kumpulan ini dapat dikaitkan dengan GUID kelas dan dapat digunakan untuk perangkat pada komputer jarak jauh.
SetupDiCreateDeviceInfo	Membuat elemen informasi perangkat baru dan menambahkannya sebagai anggota baru ke kumpulan informasi perangkat yang ditentukan.
SetupDiOpenDeviceInfo	Mengambil informasi tentang instans perangkat yang ada dan menambahkannya ke kumpulan informasi perangkat yang ditentukan.
SetupDiEnumDeviceInfo	Mengembalikan struktur konteks untuk elemen informasi perangkat dari kumpulan informasi perangkat.
SetupDiGetDeviceInstanceId	Mengambil ID instans perangkat yang terkait dengan elemen informasi perangkat.
SetupDiGetDeviceInfoListClass	Mengambil GUID kelas yang terkait dengan set informasi perangkat jika memiliki kelas terkait.
SetupDiGetDeviceInfoListDetail	Mengambil informasi yang terkait dengan satu set informasi perangkat termasuk GUID kelas, handle komputer jarak jauh, serta nama komputer jarak jauh.
SetupDiGetClassDevPropertySheets	Mengambil pegangan ke lembar properti dari elemen informasi perangkat yang ditentukan atau kelas pengaturan perangkat dari sekumpulan informasi perangkat yang ditentukan.
SetupDiGetClassDevs	Mengembalikan set informasi perangkat yang berisi semua perangkat kelas tertentu.
SetupDiGetClassDevsEx	Mengembalikan set informasi perangkat yang berisi semua perangkat kelas tertentu pada komputer lokal atau jarak jauh.
SetupDiSetSelectedDevice	Mengatur elemen informasi perangkat yang ditentukan menjadi anggota set informasi perangkat yang saat ini dipilih. Fungsi ini biasanya digunakan oleh panduan penginstalan.
SetupDiGetSelectedDevice	Mengambil perangkat yang saat ini dipilih dalam kumpulan informasi perangkat yang ditentukan.
SetupDiRegisterDeviceInfo	Mendaftarkan instans perangkat yang baru dibuat dengan manajer Plug and Play.
SetupDiDeleteDeviceInfo	Menghapus anggota dari kumpulan informasi perangkat yang ditentukan. Fungsi ini tidak menghapus perangkat yang sebenarnya.
SetupDiDestroyDeviceInfoList	Menghancurkan set informasi perangkat dan membebaskan semua memori terkait.

Fungsi Informasi Pengemudi

SetupDiBuildDriverInfoList	Membangun daftar driver yang terkait dengan instans perangkat tertentu atau dengan daftar driver kelas global kumpulan informasi perangkat.
SetupDiEnumDriverInfo	Mendaftarkan anggota dalam daftar informasi pengemudi.
SetupDiGetDriverInfoDetail	Mengambil informasi terperinci untuk elemen informasi driver tertentu.
SetupDiSetSelectedDriver	Menyetel anggota yang ditentukan dari daftar driver sebagai driver terpilih saat ini. Ini juga dapat digunakan untuk mengatur ulang daftar driver sehingga tidak ada driver yang saat ini dipilih.
SetupDiGetSelectedDriver	Mengambil elemen dari daftar driver yang dipilih sebagai driver yang akan diinstal.
SetupDiCancelDriverInfoSearch	Membatalkan pencarian daftar pengandar (driver) yang saat ini sedang berlangsung di thread yang berbeda.
SetupDiDestroyDriverInfoList	Menghancurkan daftar informasi driver.

Penanganan Penginstalan Perangkat

SetupDiCallClassInstaller	Memanggil penginstal kelas yang sesuai, dan penginstal bersama yang terdaftar, dengan permintaan penginstalan yang ditentukan.
SetupDiChangeState	Handler default untuk permintaan DIF_PROPERTYCHANGE. Ini dapat digunakan untuk mengubah status perangkat yang diinstal.
SetupDiRegisterCoDeviceInstallers	Mendaftarkan rekan penginstal khusus perangkat yang tercantum dalam file INF untuk perangkat yang ditentukan. Fungsi ini adalah handler default untuk DIF_REGISTER_COINSTALLERS.
SetupDiInstallDevice	Handler default untuk permintaan DIF_INSTALLDEVICE.
SetupDiInstallDriverFiles	Handler default untuk permintaan DIF_INSTALLDEVICEFILES.
SetupDiInstallDeviceInterfaces	Handler default untuk permintaan DIF_INSTALLINTERFACES. Ini menginstal antarmuka yang tercantum dalam DDInstall.Antarmuka bagian dari file INF perangkat.
SetupDiMoveDuplicateDevice	Fungsi ini kedaluarsa dan tidak dapat digunakan dalam versi Microsoft Windows apa pun.
SetupDiRemoveDevice	Handler default untuk permintaan DIF_REMOVEDEVICE.
SetupDiUnremoveDevice	Handler default untuk permintaan DIF_UNREMOVE.
SetupDiRegisterDeviceInfo	Handler default untuk permintaan DIF_REGISTERDEVICE.
SetupDiSelectDevice	Handler default untuk permintaan DIF_SELECTDEVICE.
SetupDiSelectBestCompatDrv	Handler default untuk permintaan DIF_SELECTBESTCOMPATDRV.
SetupDiSelectDevice	Handler default untuk permintaan DIF_SELECTDEVICE.

Fungsi Kustomisasi Penginstalan Perangkat

SetupDiGetClassInstallParams	Mengambil parameter penginstalan kelas untuk set informasi perangkat atau elemen informasi perangkat tertentu.
SetupDiSetClassInstallParams	Mengatur atau menghapus parameter penginstalan kelas untuk kumpulan informasi perangkat atau elemen informasi perangkat tertentu.
SetupDiGetDeviceInstallParams	Mengambil parameter penginstalan perangkat untuk set informasi perangkat atau elemen informasi perangkat tertentu.
SetupDiSetDeviceInstallParams	Mengatur parameter penginstalan perangkat untuk set informasi perangkat atau elemen informasi perangkat tertentu.
SetupDiGetDriverInstallParams	Mengambil parameter penginstalan untuk driver yang ditentukan.
SetupDiSetDriverInstallParams	Mengatur parameter penginstalan untuk driver yang ditentukan.

Fungsi Penyiapan Kelas

SetupDiBuildClassInfoList	Mengembalikan daftar GUID kelas penyiapan yang mencakup setiap kelas yang diinstal pada sistem.
SetupDiBuildClassInfoListEx	Mengembalikan daftar GUID kelas penyiapan yang mencakup setiap kelas yang diinstal pada sistem lokal atau sistem jarak jauh.
SetupDiGetClassDescription	Mengambil deskripsi kelas yang terkait dengan GUID kelas penyiapan yang ditentukan.
SetupDiGetClassDescriptionEx	Mengambil deskripsi dari kelas pengaturan yang terinstal pada komputer lokal atau jarak jauh.
SetupDiGetINFClass	Mengambil kelas dari file INF perangkat yang ditentukan.
SetupDiClassGuidsFromName	Mengambil GUID yang terkait dengan nama kelas yang ditentukan. Daftar ini dibangun berdasarkan kelas apa yang saat ini diinstal pada sistem.
SetupDiClassGuidsFromNameEx	Mengambil GUID yang terkait dengan nama kelas yang ditentukan. Daftar yang dihasilkan ini berisi kelas yang saat ini diinstal pada komputer lokal atau jarak jauh.
SetupDiClassNameFromGuid	Mengambil nama kelas yang terkait dengan GUID.
SetupDiClassNameFromGuidEx	Mengambil nama kelas yang diasosiasikan dengan GUID kelas. Kelas dapat diinstal pada komputer lokal atau jarak jauh.
SetupDiInstallClass	Menginstal bagian ClassInstall32 dari file INF yang ditentukan.
SetupDiInstallClassEx	Menginstal kelas penginstal atau kelas antarmuka.
SetupDiOpenClassRegKey	Membuka kelas penyiapan perangkat kunci registri, atau subkuntang kelas tertentu.
SetupDiOpenClassRegKeyEx	Membuka kunci registri kelas penyetelan perangkat, kunci registri kelas antarmuka perangkat, atau subkunci tertentu dari kelas tersebut. Fungsi ini membuka kunci yang ditentukan pada komputer lokal atau pada komputer jarak jauh.

Bitmap dan Fungsi Ikon

SetupDiGetClassImageList	Membangun daftar gambar yang berisi bitmap untuk setiap kelas yang diinstal dan mengembalikan daftar dalam struktur data.
SetupDiGetClassImageListEx	Membangun daftar gambar bitmap untuk setiap kelas yang diinstal pada komputer lokal atau jarak jauh.
SetupDiGetClassImageIndex	Mengambil indeks dalam daftar gambar kelas dari kelas tertentu.
SetupDiGetClassBitmapIndex	Mengambil indeks ikon mini yang disediakan untuk kelas yang ditentukan.
SetupDiDrawMiniIcon	Menggambar ikon mini yang ditentukan di lokasi yang diminta.
SetupDiLoadClassIcon	Memuat ikon besar dan mini untuk kelas yang ditentukan.
SetupDiLoadDeviceIcon	Memuat ikon perangkat untuk perangkat tertentu. (Windows Vista dan versi Windows yang lebih baru)
SetupDiDestroyClassImageList	Menghancurkan daftar gambar dalam kelas.

Fungsi Antarmuka Perangkat

Nota

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.

SetupDiCreateDeviceInterface	Mendaftarkan fungsionalitas perangkat (antarmuka perangkat) untuk perangkat.
SetupDiOpenDeviceInterface	Mengambil informasi tentang antarmuka perangkat yang ada dan menambahkannya ke kumpulan informasi perangkat yang ditentukan.
SetupDiGetDeviceInterfaceAlias	Mengembalikan alias antarmuka perangkat yang ditentukan.
SetupDiGetClassDevs	Mengembalikan set informasi perangkat yang berisi semua perangkat kelas tertentu.
SetupDiGetClassDevsEx	Mengembalikan set informasi perangkat yang berisi semua perangkat kelas tertentu pada komputer lokal atau jarak jauh.
SetupDiEnumDeviceInterfaces	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.
SetupDiGetDeviceInterfaceDetail	Mengembalikan detail tentang antarmuka perangkat tertentu.
SetupDiCreateDeviceInterfaceRegKey	Membuat subkunci registri untuk menyimpan informasi tentang instans antarmuka perangkat dan mengembalikan pegangan ke kunci.
SetupDiOpenDeviceInterfaceRegKey	Membuka subkunci registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk instance antarmuka perangkat dan mengembalikan handle ke kunci.
SetupDiDeleteDeviceInterfaceRegKey	Menghapus subkunci registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk instans antarmuka perangkat.
SetupDiInstallDeviceInterfaces	Adalah handler default untuk permintaan DIF_INSTALLINTERFACES. Ini menginstal Antarmuka yang tercantum dalam bagian DDInstall.Interfaces dari file INF perangkat.
SetupDiRemoveDeviceInterface	Menghapus antarmuka perangkat terdaftar dari sistem.
SetupDiDeleteDeviceInterfaceData	Menghapus antarmuka perangkat dari set informasi perangkat.
SetupDiSetDeviceInterfaceDefault	Mengatur antarmuka perangkat tertentu sebagai antarmuka default untuk kelas perangkat.
SetupDiInstallClassEx	Menginstal pengelola kelas atau kelas antarmuka.
SetupDiOpenClassRegKeyEx	Membuka kelas penyiapan perangkat kunci registri, kunci registri kelas antarmuka perangkat, atau subkuntang kelas tertentu. Fungsi ini membuka kunci yang ditentukan pada komputer lokal atau pada komputer jarak jauh.

Fungsi Properti Perangkat (Windows Vista dan Yang Lebih Baru)

Nota

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.

SetupDiGetClassProperty	Mengambil properti perangkat yang diatur untuk kelas penyiapan perangkat atau kelas antarmuka perangkat.
SetupDiGetClassPropertyEx	Mengambil properti kelas untuk kelas penyiapan perangkat atau kelas antarmuka perangkat di komputer lokal atau jarak jauh.
SetupDiGetClassPropertyKeys	Mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk kelas penyiapan perangkat atau kelas antarmuka perangkat.
SetupDiGetClassPropertyKeysEx	Mengambil array kunci properti perangkat yang mewakili properti perangkat yang diatur untuk kelas penyiapan perangkat atau kelas antarmuka perangkat pada komputer lokal atau jarak jauh.
SetupDiGetDeviceInterfaceProperty	Mengambil properti perangkat yang ditetapkan pada antarmuka perangkat.
SetupDiGetDeviceInterfacePropertyKeys	Mengambil array kunci properti perangkat yang mewakili properti perangkat yang telah ditetapkan untuk sebuah antarmuka perangkat.
SetupDiGetDeviceProperty	Mengambil properti instans perangkat.
SetupDiGetDevicePropertyKeys	Memperoleh array kunci properti perangkat yang mewakili properti perangkat yang ditetapkan untuk instans perangkat.
SetupDiSetClassProperty	Mengatur properti kelas untuk kelas penyiapan perangkat atau kelas antarmuka perangkat.
SetupDiSetClassPropertyEx	Mengatur properti perangkat untuk kelas penyiapan perangkat atau kelas antarmuka perangkat di komputer lokal atau jarak jauh.
SetupDiSetDeviceInterfaceProperty	Mengatur properti perangkat dari antarmuka perangkat.
SetupDiSetDeviceProperty	Mengatur properti instans perangkat.

Fungsi Registri

Nota

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.

SetupDiCreateDevRegKey	Membuat kunci penyimpanan registri untuk informasi konfigurasi yang spesifik untuk perangkat dan mengembalikan referensi ke kunci tersebut.
SetupDiOpenDevRegKey	Membuka kunci penyimpanan registri untuk informasi konfigurasi khusus perangkat dan mengembalikan handel ke kunci.
SetupDiDeleteDevRegKey	Menghapus kunci registri yang dapat diakses pengguna yang ditentukan yang terkait dengan elemen informasi perangkat.
SetupDiOpenClassRegKey	Membuka kunci registri kelas penyiapan, atau subkunci tertentu dari kelas.
SetupDiOpenClassRegKeyEx	Membuka kunci registri kelas penyiapan perangkat, kunci registri kelas antarmuka perangkat, atau subkunci dari kelas tertentu. Fungsi ini membuka kunci yang ditentukan pada komputer lokal atau pada komputer jarak jauh.
SetupDiCreateDeviceInterfaceRegKey	Membuat subkunci registri nonvolatile untuk menyimpan informasi tentang instans antarmuka perangkat, dan mengembalikan handle ke kunci.
SetupDiOpenDeviceInterfaceRegKey	Membuka subkunci registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk instans antarmuka perangkat dan mengembalikan sebuah handle kepada kunci.
SetupDiDeleteDeviceInterfaceRegKey	Menghapus subkunci registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk instans antarmuka perangkat.
SetupDiSetDeviceRegistryProperty	Mengatur properti perangkat Plug and Play yang ditentukan.
SetupDiGetDeviceRegistryProperty	Mengambil properti perangkat Plug and Play yang telah ditentukan.
SetupDiGetClassRegistryProperty	Mengambil properti kelas perangkat tertentu dari registri.
SetupDiSetClassRegistryProperty	Mengatur properti kelas perangkat tertentu dalam registri.

Fungsi Lain

SetupDiGetActualModelsSection	Mengambil bagian Model INF yang didekorasi yang sesuai untuk digunakan saat menginstal perangkat dari file INF perangkat.
Given no specific translation requirements for placeholders or technical terms, no changes are proposed. Therefore, the translation remains the same: SetupDiGetActualSectionToInstall	Mengambil bagian DDInstall yang sesuai untuk digunakan saat menginstal perangkat dari file INF perangkat.
SetupDiGetActualSectionToInstallEx	Mengambil nama bagian INF DDInstall yang menginstal perangkat untuk sistem operasi dan arsitektur prosesor tertentu.
SetupDiGetHwProfileFriendlyName	Mengambil nama yang mudah diingat yang terkait dengan ID profil perangkat keras.
SetupDiGetHwProfileFriendlyNameEx	Mengambil nama ramah pengguna yang terkait dengan ID profil perangkat keras pada komputer lokal atau jarak jauh.
SetupDiGetHwProfileList	Mengambil daftar semua ID profil perangkat keras yang saat ini sudah ditetapkan.
SetupDiGetHwProfileListEx	Mengambil daftar semua ID profil perangkat keras yang saat ini ditentukan pada komputer lokal atau jarak jauh.
SetupDiRestartDevices	Memulai ulang perangkat tertentu atau, jika perlu, memulai semua perangkat yang dioperasikan oleh driver fungsi dan filter yang sama seperti perangkat yang ditentukan.