Fungsi SetupDiSetDeviceInterfaceDefault (setupapi.h)
Fungsi SetupDiSetDeviceInterfaceDefault menetapkan antarmuka perangkat sebagai antarmuka default untuk kelas antarmuka perangkat.
Sintaks
WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
[in] DWORD Flags,
PVOID Reserved
);
Parameter
[in] DeviceInfoSet
Handel ke kumpulan informasi perangkat yang berisi antarmuka perangkat untuk diatur sebagai default untuk kelas antarmuka perangkat.
[in, out] DeviceInterfaceData
Penunjuk ke struktur SP_DEVICE_INTERFACE_DATA yang menentukan antarmuka perangkat di DeviceInfoSet.
[in] Flags
Tidak digunakan, harus nol.
Reserved
Dicadangkan untuk digunakan di masa mendatang, harus NULL.
Nilai kembali
Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ia mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.
Keterangan
Penelepon harus memiliki hak istimewa Administrator untuk mengatur antarmuka default untuk kelas antarmuka perangkat. Namun, jika antarmuka default yang diminta sama dengan antarmuka default yang saat ini diatur, fungsi mengembalikan TRUE terlepas dari apakah pemanggil memiliki hak istimewa Administrator.
Jika fungsi berhasil mengatur antarmuka perangkat yang ditentukan sebagai default untuk kelas perangkat, fungsi memperbarui anggota Bendera dari struktur SP_DEVICE_INTERFACE_DATA yang disediakan.
Panggil SetupDiGetClassDevs untuk mendapatkan handel DevInfoSet ke kumpulan informasi perangkat yang berisi antarmuka perangkat untuk diatur sebagai default untuk kelas antarmuka perangkat. Untuk mendapatkan penunjuk DeviceInterfaceData ke elemen antarmuka perangkat, panggil SetupDiEnumDeviceInterfaces untuk menghitung antarmuka dalam kumpulan informasi perangkat. Untuk mengambil informasi tentang antarmuka yang dijumlahkan, panggil SetupDiGetDeviceInterfaceDetail.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows XP dan versi Windows yang lebih baru. |
Target Platform | Desktop |
Header | setupapi.h (termasuk Setupapi.h) |
Pustaka | Setupapi.lib |
DLL | Setupapi.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk