struktur SP_DEVINFO_DATA (setupapi.h)
Struktur SP_DEVINFO_DATA mendefinisikan instans perangkat yang merupakan anggota set informasi perangkat.
Sintaks
typedef struct _SP_DEVINFO_DATA {
DWORD cbSize;
GUID ClassGuid;
DWORD DevInst;
ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;
Anggota
cbSize
Ukuran, dalam byte, dari struktur SP_DEVINFO_DATA. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
ClassGuid
GUID kelas penyiapan perangkat.
DevInst
Handel buram ke instans perangkat (juga dikenal sebagai handel ke devnode).
Beberapa fungsi, seperti fungsi SetupDiXxx , mengambil seluruh struktur SP_DEVINFO_DATA sebagai input untuk mengidentifikasi perangkat dalam set informasi perangkat. Fungsi lain, seperti fungsi CM_Xxx seperti CM_Get_DevNode_Status, ambil handel DevInst ini sebagai input.
Reserved
Dicadangkan. Hanya untuk penggunaan internal.
Keterangan
Struktur SP_DEVINFO_DATA mengidentifikasi perangkat dalam kumpulan informasi perangkat. Misalnya, ketika Windows mengirim permintaan DIF_INSTALLDEVICE ke penginstal kelas dan penginstal bersama, windows menyertakan handel ke set informasi perangkat dan penunjuk ke SP_DEVINFO_DATA yang menentukan perangkat tertentu. Selain permintaan DIF, struktur ini juga digunakan dalam beberapa fungsi SetupDiXxx .
Fungsi SetupDiXxx yang mengambil struktur SP_DEVINFO_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.
Persyaratan
| Header | setupapi.h (termasuk Setupapi.h) |