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)

Lihat juga

SP_DEVINFO_LIST_DETAIL_DATA