struktur SP_SELECTDEVICE_PARAMS_A (setupapi.h)

Artikel
03/04/2024

Struktur SP_SELECTDEVICE_PARAMS sesuai dengan permintaan penginstalan DIF_SELECTDEVICE .

Sintaks

typedef struct _SP_SELECTDEVICE_PARAMS_A {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  CHAR                   Title[MAX_TITLE_LEN];
  CHAR                   Instructions[MAX_INSTRUCTION_LEN];
  CHAR                   ListLabel[MAX_LABEL_LEN];
  CHAR                   SubTitle[MAX_SUBTITLE_LEN];
  BYTE                   Reserved[2];
} SP_SELECTDEVICE_PARAMS_A, *PSP_SELECTDEVICE_PARAMS_A;

Anggota

ClassInstallHeader

Header permintaan penginstalan yang berisi ukuran header dan kode DIF untuk permintaan tersebut. Lihat SP_CLASSINSTALL_HEADER.

Title[MAX_TITLE_LEN]

Buffer yang berisi judul jendela yang disediakan alat penginstal untuk jendela pemilihan driver. Windows menggunakan judul ini untuk judul jendela untuk dialog Pilih Perangkat.

Instructions[MAX_INSTRUCTION_LEN]

Buffer yang berisi instruksi perangkat tertentu yang disediakan alat penginstal.

ListLabel[MAX_LABEL_LEN]

Buffer yang berisi label yang disediakan alat penginstal untuk daftar driver tempat pengguna dapat memilih.

SubTitle[MAX_SUBTITLE_LEN]

Buffer yang berisi subtitel yang disediakan alat penginstal yang digunakan dalam wizard select-device. String ini tidak digunakan dalam dialog pilih.

Reserved[2]

Dicadangkan. Hanya untuk penggunaan internal.

Keterangan

Jika alat penginstal mengatur bidang dalam struktur ini untuk digunakan selama pemilihan driver, alat penginstal juga harus mengatur bendera DI_USECI_SELECTSTRINGS di SP_DEVINSTALL_PARAMS.

Cuplikan layar berikut menunjukkan contoh kotak dialog Pilih Perangkat dan mengidentifikasi string yang dapat disediakan alat penginstal.

Cuplikan layar kotak dialog Pilih Driver Perangkat

Catatan

Header setupapi.h mendefinisikan SP_SELECTDEVICE_PARAMS sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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.