SP_DRVINFO_DATA_V2_W struktur (setupapi.h)
Struktur SP_DRVINFO_DATA berisi informasi tentang driver. Struktur ini adalah anggota daftar informasi driver yang dapat dikaitkan dengan instans perangkat tertentu atau secara global dengan kumpulan informasi perangkat.
Sintaks
typedef struct _SP_DRVINFO_DATA_V2_W {
DWORD cbSize;
DWORD DriverType;
ULONG_PTR Reserved;
WCHAR Description[LINE_LEN];
WCHAR MfgName[LINE_LEN];
WCHAR ProviderName[LINE_LEN];
FILETIME DriverDate;
DWORDLONG DriverVersion;
} SP_DRVINFO_DATA_V2_W, *PSP_DRVINFO_DATA_V2_W;
Anggota
cbSize
Ukuran, dalam byte, dari struktur SP_DRVINFO_DATA. Untuk informasi selengkapnya, lihat bagian Keterangan dalam topik ini.
DriverType
Jenis driver yang diwakili oleh struktur ini. Harus salah satu nilai berikut:
SPDIT_CLASSDRIVER
Struktur ini mewakili driver kelas.
SPDIT_COMPATDRIVER
Struktur ini mewakili driver yang kompatibel.
Reserved
Dicadangkan. Hanya untuk penggunaan internal.
Description[LINE_LEN]
String yang dihentikan NULL yang menjelaskan perangkat yang didukung oleh driver ini.
MfgName[LINE_LEN]
String yang dihentikan NULL yang berisi nama produsen perangkat yang didukung oleh driver ini.
ProviderName[LINE_LEN]
String yang dihentikan NULL yang memberikan penyedia driver ini. Ini biasanya adalah nama organisasi yang membuat driver atau file INF. ProviderName dapat berupa string kosong.
DriverDate
Tanggal pengemudi. Dari entri DriverVer dalam file INF. Lihat Bagian INF DDInstall untuk informasi selengkapnya tentang entri DriverVer .
DriverVersion
Versi driver. Dari entri DriverVer dalam file INF.
Keterangan
Di SetupAPI.h, struktur ini sama dengan SP_DRVINFO_DATA_V1 atau SP_DRVINFO_DATA_V2, berdasarkan apakah Anda menyertakan baris berikut dalam kode sumber Anda:
#define USE_SP_DRVINFO_DATA_V1 1
Tentukan pengidentifikasi ini hanya jika komponen Anda harus berjalan pada Windows 98 atau Edisi Milenium, atau pada Windows NT. Jika komponen Anda hanya dijalankan di Windows 2000 dan versi Windows yang lebih baru, jangan tentukan pengidentifikasi. Jika pengidentifikasi tidak ditentukan, SP_DRVINFO_DATA_V2 digunakan.
SP_DRVINFO_DATA_V1 tidak berisi anggota DriverDate dan DriverVersion .
Fungsi SetupDiXxx yang mengambil struktur SP_DRVINFO_DATA sebagai parameter memverifikasi bahwa anggota cbSize dari struktur yang disediakan sama dengan ukuran, dalam byte, dari struktur. Jika anggota cbSize tidak diatur dengan benar untuk parameter input, fungsi akan gagal dan mengatur kode kesalahan ERROR_INVALID_PARAMETER. Jika anggota cbSize tidak diatur dengan benar untuk parameter output, fungsi akan gagal dan mengatur kode kesalahan ERROR_INVALID_USER_BUFFER.
Catatan
Header setupapi.h mendefinisikan SP_DRVINFO_DATA_V2 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.
Persyaratan
Header | setupapi.h (termasuk Setupapi.h) |