Fungsi SetupDiSetDeviceInterfaceDefault (setupapi.h)

Artikel
03/01/2024

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

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail

Share via