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.

Fungsi CM_Get_DevNode_Status mengambil status dan kode masalah untuk instans perangkat dan fungsi SetupDiGetDeviceInstallParams mengambil parameter penginstalan perangkat untuk elemen informasi perangkat yang mewakili instans perangkat.

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

Lihat juga

CM_Get_DevNode_Status

DIF_INSTALLDEVICE

SP_DEVINFO_DATA

SetupDiGetDeviceInstallParams