Fungsi SetupDiSelectOEMDrv (setupapi.h)
Fungsi SetupDiSelectOEMDrv memilih driver untuk set informasi perangkat atau elemen informasi perangkat tertentu yang menggunakan jalur OEM yang disediakan oleh pengguna.
Sintaks
WINSETUPAPI BOOL SetupDiSelectOEMDrv(
[in, optional] HWND hwndParent,
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData
);
Parameter
[in, optional] hwndParent
Handel jendela yang akan menjadi induk dari dialog apa pun yang dibuat selama pemrosesan fungsi ini. Parameter ini dapat digunakan untuk mengambil alih bidang hwndParent di blok parameter penginstalan dari set atau elemen informasi perangkat yang ditentukan.
[in] DeviceInfoSet
Handel ke set informasi perangkat untuk memilih driver.
[in, out] DeviceInfoData
Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, SetupDiSelectOEMDrv mengaitkan driver yang dipilih dengan perangkat yang ditentukan. Jika parameter ini NULL, SetupDiSelectOEMDrv mengaitkan driver yang dipilih dengan daftar driver kelas global untuk DeviceInfoSet.
Menampilkan nilai
Fungsi mengembalikan TRUE jika berhasil. Jika tidak, kesalahan mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.
Keterangan
SetupDiSelectOEMDrv terutama dirancang untuk memilih driver OEM untuk perangkat di komputer lokal sebelum menginstal perangkat di komputer tersebut. Meskipun SetupDiSelectOEMDrv tidak akan gagal jika kumpulan informasi perangkat adalah untuk komputer jarak jauh, hasilnya adalah penggunaan terbatas karena kumpulan informasi perangkat kemudian tidak dapat digunakan dengan permintaan penginstalan DIF_Xxx atau fungsi SetupDiXxx yang tidak mendukung operasi pada komputer jarak jauh. Secara khusus, set informasi perangkat tidak dapat digunakan sebagai input dengan permintaan penginstalan DIF_INSTALLDEVICE untuk menginstal perangkat di komputer jarak jauh.
SetupDiSelectOEMDrv meminta pengguna untuk jalur OEM lalu memanggil penginstal kelas untuk memilih driver dari jalur OEM.
Persyaratan
| 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 |
| DLL | Setupapi.dll |