Fungsi SetupDiRestartDevices (setupapi.h)
Fungsi SetupDiRestartDevices memulai ulang perangkat tertentu atau, jika perlu, memulai ulang semua perangkat yang dioperasikan oleh fungsi dan driver filter yang sama yang mengoperasikan perangkat yang ditentukan.
Sintaks
WINSETUPAPI BOOL SetupDiRestartDevices(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData
);
Parameter
[in] DeviceInfoSet
Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk dimulai ulang.
[in, out] DeviceInfoData
Penunjuk ke struktur SP_DEVINFO_DATA untuk anggota informasi perangkat yang mewakili perangkat untuk memulai ulang. Parameter ini juga merupakan parameter output karena SetupDiRestartDevices memperbarui parameter penginstalan perangkat untuk anggota informasi perangkat ini serta status dan kode masalah instans perangkat yang sesuai. Untuk informasi selengkapnya tentang pembaruan ini, lihat bagian Keterangan berikut ini.
Nilai kembali
Jika operasi berhasil, SetupDiRestartDevices mengembalikan TRUE; jika tidak, fungsi mengembalikan FALSE dan kesalahan yang dicatat dapat diambil oleh panggilan ke GetLastError.
Keterangan
SetupDiRestartDevices harus dipanggil hanya oleh penginstal kelas ketika alat penginstal kelas menangani permintaan DIF_INSTALLDEVICE dan hanya dalam situasi yang jarang terjadi di mana alat penginstal kelas harus melakukan operasi setelah semua operasi penginstalan default, kecuali untuk memulai perangkat, telah selesai . Untuk informasi selengkapnya tentang memanggil SetupDiRestartDevices dalam situasi ini, lihat DIF_INSTALLDEVICE.
SetupDiRestartDevices hanya memulai ulang perangkat yang ditentukan jika mulai ulang dapat dilakukan tanpa memengaruhi penginstalan perangkat lain yang dioperasikan oleh driver fungsi yang sama atau driver filter yang mengoperasikan perangkat. Secara khusus, jika mulai ulang perangkat yang ditentukan tidak menyalin file baru atau memodifikasi file apa pun yang sebelumnya diinstal untuk perangkat, SetupDiRestartDevices hanya memulai ulang perangkat yang ditentukan. Jika tidak, fungsi menghidupkan ulang semua perangkat yang dioperasikan oleh fungsi yang sama dan driver filter yang mengoperasikan perangkat yang ditentukan.
SetupDiRestartDevices memperbarui parameter penginstalan perangkat dan status perangkat untuk mencerminkan hasil operasi mulai ulang yang dicoba. Contohnya:
- Jika perangkat dimulai, SetupDiRestartDevices mengatur status perangkat ke DN_STARTED.
- Jika hidupkan ulang sistem diperlukan untuk memulai perangkat, SetupDiRestartDevices mengatur bendera DI_NEEDREBOOT di anggota Bendera struktur SP_DEVINSTALL_PARAMETER yang terkait dengan elemen informasi perangkat dan mengatur kode masalah untuk perangkat ke CM_PROB_NEED_RESTART.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows Server 2003 dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |
| DLL | Setupapi.dll |