Menghitung antarmuka perangkat yang terinstal

Anda tidak boleh menghitung antarmuka perangkat dalam sistem dengan langsung mengakses kunci registri. Seperti halnya kunci registri apa pun, lokasi, nama, atau format kunci mungkin berubah di antara versi Windows yang berbeda.

Gunakan panduan berikut untuk menghitung antarmuka perangkat dengan aman.

Aplikasi mode pengguna harus mengikuti langkah-langkah berikut:

• Menggunakan fungsi manajer konfigurasi :

  Gunakan CM_Get_Device_Interface_List untuk mengambil daftar antarmuka perangkat di InterfaceClassGuid yang ditentukan. Anda dapat secara opsional membatasi daftar ke hanya antarmuka perangkat yang diekspos oleh perangkat tertentu dengan mengatur parameter pDeviceID ke pengidentifikasi instans perangkat tertentu.

  Untuk menyertakan hanya antarmuka perangkat yang ada (diaktifkan) dalam sistem, atur bendera CM_GET_DEVICE_INTERFACE_LIST_PRESENT dalam parameter ulFlags .

• Menggunakan fungsi SetupApi :

  1. Gunakan SetupDiGetClassDevs atau SetupDiGetClassDevsEx dengan bendera DIGCF_DEVICEINTERFACE diatur dalam parameter Bendera untuk mengambil antarmuka perangkat untuk kelas antarmuka perangkat yang ditentukan. Anda dapat secara opsional membatasi daftar ke hanya antarmuka perangkat yang diekspos oleh perangkat tertentu dengan mengatur parameter Enumerator ke pengidentifikasi instans perangkat tertentu.

     Untuk menyertakan hanya antarmuka perangkat yang ada (diaktifkan) dalam sistem, atur bendera DIGCF_PRESENT di parameter Bendera .

  2. Gunakan SetupDiEnumDeviceInterfaces untuk menghitung antarmuka yang dikembalikan oleh panggilan di atas.

Driver mode kernel harus menggunakan IoGetDeviceInterfaces untuk mengambil daftar antarmuka perangkat di InterfaceClassGuid yang ditentukan. Anda dapat secara opsional membatasi daftar ke hanya antarmuka perangkat yang diekspos oleh perangkat tertentu dengan mengatur parameter PhysicalDeviceObject .