Fungsi SetupDiCreateDeviceInfoListExA (setupapi.h)

  • Artikel

Fungsi SetupDiCreateDeviceInfoList membuat informasi perangkat kosong yang diatur pada komputer jarak jauh atau lokal dan secara opsional mengaitkan set dengan kelas penyiapan perangkat .

Sintaks

WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExA(
  [in, optional] const GUID *ClassGuid,
  [in, optional] HWND       hwndParent,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

Parameter

[in, optional] ClassGuid

Penunjuk ke GUID kelas penyiapan perangkat untuk dikaitkan dengan kumpulan informasi perangkat yang baru dibuat. Jika parameter ini ditentukan, hanya perangkat kelas ini yang dapat disertakan dalam kumpulan informasi perangkat ini. Jika parameter ini diatur ke NULL, kumpulan informasi perangkat tidak terkait dengan kelas penyiapan perangkat tertentu.

[in, optional] hwndParent

Handel ke jendela tingkat atas yang akan digunakan untuk antarmuka pengguna apa pun yang terkait dengan tindakan non-perangkat tertentu (seperti kotak dialog pilih perangkat yang menggunakan daftar driver kelas global). Handel ini bersifat opsional dan dapat berupa NULL. Jika jendela tingkat atas tertentu tidak diperlukan, atur hwndParent ke NULL.

[in, optional] MachineName

Penunjuk ke string yang dihentikan NULL yang berisi nama komputer pada jaringan. Jika nama ditentukan, hanya perangkat pada komputer tersebut yang dapat dibuat dan dibuka dalam set informasi perangkat ini. Jika parameter ini diatur ke NULL, set informasi perangkat adalah untuk perangkat di komputer lokal.

Perhatian

Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsi ini telah dihapus.

Reserved

Harus NULL.

Mengembalikan nilai

Fungsi mengembalikan handel ke set informasi perangkat kosong jika berhasil. Jika tidak, ia mengembalikan INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Pemanggil fungsi ini harus menghapus informasi perangkat yang dikembalikan yang ditetapkan ketika tidak lagi diperlukan dengan memanggil SetupDiDestroyDeviceInfoList.

Jika set informasi perangkat adalah untuk perangkat di komputer jarak jauh (MachineName bukan NULL), semua operasi berikutnya pada set ini atau elemennya harus menggunakan rutinitas yang mendukung kumpulan informasi perangkat dengan elemen jarak jauh. Rutinitas SetupDiXxx yang tidak menyediakan dukungan ini, seperti SetupDiCallClassInstaller, memiliki pernyataan untuk efek tersebut di halaman referensi mereka.

Catatan

Header setupapi.h mendefinisikan SetupDiCreateDeviceInfoListEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform Desktop
Header setupapi.h (termasuk Setupapi.h)
Pustaka Setupapi.lib

Lihat juga

SetupDiCreateDeviceInfoList

SetupDiDestroyDeviceInfoList

SetupDiGetDeviceInfoListDetail