SP_DRVINFO_DATA_V1_W struktur (setupapi.h)

Artikel
08/26/2023

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_V1_W {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  WCHAR     Description[LINE_LEN];
  WCHAR     MfgName[LINE_LEN];
  WCHAR     ProviderName[LINE_LEN];
} SP_DRVINFO_DATA_V1_W, *PSP_DRVINFO_DATA_V1_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.

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_V1 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.