Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Struktur SP_DRVINSTALL_PARAMS berisi parameter penginstalan driver yang terkait dengan elemen informasi driver tertentu.
Sintaks
typedef struct _SP_DRVINSTALL_PARAMS {
DWORD cbSize;
DWORD Rank;
DWORD Flags;
DWORD_PTR PrivateData;
DWORD Reserved;
} SP_DRVINSTALL_PARAMS, *PSP_DRVINSTALL_PARAMS;
Anggota
cbSize
Ukuran, dalam byte, dari struktur SP_DRVINSTALL_PARAMS.
Rank
Kecocokan peringkat driver ini. Berkisar dari 0 hingga n, di mana 0 adalah yang paling kompatibel.
Flags
Bendera yang mengontrol fungsi yang beroperasi pada driver ini. Dapat berupa kombinasi dari berikut ini:
DNF_ALWAYSEXCLUDEFROMLIST (Windows Vista dan versi Windows yang lebih baru)
Jika diatur, bendera ini mencegah node driver dijumlahkan, terlepas dari klien yang melakukan enumerasi.
DNF_AUTHENTICODE_SIGNED (Windows Server 2003 dan versi Windows yang lebih baru)
File INF driver ini ditandatangani oleh tanda tangan Authenticode. Bendera ini bersifat baca-saja untuk penginstal.
Untuk informasi selengkapnya, lihat Menggunakan SetupAPI untuk Memverifikasi Tanda Tangan Authenticode Driver.
DNF_BAD_DRIVER
Jangan gunakan pengandar ini. Alat penginstal dapat membaca dan menulis bendera ini.
Jika bendera ini diatur, SetupDiSelectBestCompatDrv dan SetupDiSelectDevice mengabaikan driver ini.
Penginstal kelas atau penginstal bersama dapat mengatur bendera ini untuk mencegah Windows mencantumkan driver dalam kotak dialog Pilih Driver. Alat penginstal mungkin mengatur bendera ini saat menangani permintaan DIF_SELECTDEVICE atau DIF_SELECTBESTCOMPATDRV , misalnya.
DNF_BASIC_DRIVER (Windows XP dan versi Windows yang lebih baru)
Driver ini adalah driver dasar. Bendera ini bersifat baca-saja untuk penginstal.
DNF_CLASS_DRIVER
Driver ini adalah driver kelas. Bendera ini bersifat baca-saja untuk penginstal.
DNF_COMPATIBLE_DRIVER
Driver ini adalah driver yang kompatibel. Bendera ini bersifat baca-saja untuk penginstal.
DNF_DUPDESC
Ada penyedia lain yang menyediakan driver yang memiliki deskripsi yang sama dengan driver ini. Bendera ini bersifat baca-saja untuk penginstal.
DNF_DUPDRIVERVER (Windows XP dan versi Windows yang lebih baru)
Ada penyedia lain yang menyediakan driver yang memiliki versi yang sama dengan driver ini. Bendera ini bersifat baca-saja untuk penginstal.
DNF_DUPPROVIDER
Ada penyedia lain yang menyediakan driver yang memiliki deskripsi yang sama dengan driver ini. Satu-satunya perbedaan antara driver ini dan kecocokannya adalah tanggal driver. Bendera ini bersifat baca-saja untuk penginstal.
Jika bendera ini diatur, Windows menampilkan tanggal driver dan versi driver di samping driver sehingga pengguna dapat membedakannya dari kecocokannya.
DNF_EXCLUDEFROMLIST
Jangan tampilkan pengandar ini dalam dialog pemilih driver.
DNF_INBOX_DRIVER (Windows Vista dan versi Windows yang lebih baru)
Simpul pengandar ini berasal dari berkas INF yang disertakan dengan versi Windows ini.
DNF_INET_DRIVER
Driver ini berasal dari Internet atau dari Windows Update. Bendera ini bersifat baca-saja untuk penginstal.
Jika Anda memanggil SetupCopyOEMInf, Anda harus menentukan bendera SPOST_URL sehingga ketika Windows menyalin INF ini ke direktoriinf %SystemRoot%\, Windows akan menandainya sebagai INF Internet. Jika Anda menghilangkan langkah ini maka Windows akan mencoba menggunakan perangkat ini untuk menginstal perangkat lain. Masalah yang dihasilkan adalah Windows tidak memiliki file sumber lagi dan akhirnya akan meminta pengguna dengan jalur yang tidak valid.
DNF_INF_IS_SIGNED (Windows XP dan versi Windows yang lebih baru)
Bendera ini baca-saja untuk penginstal, dan diatur jika salah satu kondisi berikut ini benar:
- Driver memiliki tanda tangan rilis WHQL.
- Driver adalah driver kotak masuk.
- Driver memiliki tanda tangan Authenticode.
DNF_INSTALLEDDRIVER (Windows Vista dan versi Windows yang lebih baru)
Simpul pengandar ini saat ini terinstal untuk perangkat. Bendera ini bersifat baca-saja untuk penginstal.
DNF_LEGACYINF
Driver ini berasal dari file INF warisan. Bendera ini hanya berlaku untuk sistem operasi berbasis NT. Bendera ini bersifat baca-saja untuk penginstal.
DNF_NODRIVER
Atur jika tidak ada driver fisik yang akan diinstal untuk driver logis ini.
DNF_OEM_F6_INF (Windows XP dan versi Windows yang lebih baru)
Dicadangkan.
DNF_OLD_INET_DRIVER
Pengandar ini berasal dari Internet, tetapi Windows saat ini tidak memiliki akses ke berkas sumbernya. Bendera ini bersifat baca-saja untuk penginstal.
Sistem tidak akan menginstal pengandar yang ditandai dengan bendera ini karena Windows tidak memiliki file sumber dan akhirnya akan meminta pengguna dengan jalur yang tidak valid. INF untuk driver seperti itu dapat digunakan untuk semuanya kecuali untuk menginstal perangkat.
DNF_OLDDRIVER
Pengandar ini saat ini/sebelumnya mengontrol perangkat terkait. Bendera ini bersifat baca-saja untuk penginstal.
DNF_REQUESTADDITIONALSOFTWARE (Windows 7 dan versi Windows yang lebih baru)
Atur bendera ini jika paket driver hanya merupakan bagian dari solusi perangkat lunak yang diperlukan untuk mengoperasikan perangkat. Dalam hal ini, paket driver memerlukan penginstalan perangkat lunak tambahan.
Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
PrivateData
Bidang yang dapat digunakan alat penginstal kelas untuk menyimpan data privat. Penginstal bersama tidak boleh menggunakan bidang ini.
Reserved
Dicadangkan. Hanya untuk penggunaan internal.
Keterangan
Dimulai dengan Windows 7, penginstal atau penginstal bersama dapat mengatur bendera DNF_REQUESTADDITIONALSOFTWARE untuk menunjukkan bahwa paket driver memerlukan perangkat lunak tambahan yang mungkin atau tidak diinstal di komputer.
Setelah paket driver untuk perangkat diinstal, manajer Plug and Play (PnP) melakukan langkah-langkah berikut jika alat penginstal mengatur bendera DNF_REQUESTADDITIONALSOFTWARE:
- Manajer PnP menghasilkan laporan kesalahan Laporan Masalah dan Solusi (PRS) dengan jenis RequestAddtionalSoftware. Laporan ini berisi informasi tentang ID perangkat keras tertentu dari perangkat dan arsitektur sistem komputer.
-
Jika ada solusi yang disediakan oleh vendor perangkat keras independen (IHV) untuk perangkat lunak khusus perangkat, solusinya diunduh ke komputer.
Catatan Unduhan solusi tidak menginstal perangkat lunak itu sendiri.
- Jika perangkat lunak khusus perangkat tidak diinstal di komputer, manajer PnP menyajikan solusi kepada pengguna dan menyediakan tautan untuk mengunduh perangkat lunak. Pengguna kemudian dapat memilih untuk mengunduh dan menginstal perangkat lunak ini dengan mengikuti instruksi yang disajikan dalam solusi.
Catatan Alat penginstal tidak harus mengatur bendera DNF_REQUESTADDITIONALSOFTWARE jika file INF untuk paket driver telah mengatur bendera RequestAdditionalSoftware di Bagian INF ControlFlags.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | setupapi.h (termasuk Setupapi.h) |