Struktur WMIREGINFOW (wmistr.h)

Artikel
08/08/2023

Struktur WMIREGINFO berisi informasi yang disediakan oleh driver untuk mendaftarkan atau memperbarui blok data dan blok peristiwanya.

Sintaks

typedef struct {
  ULONG       BufferSize;
  ULONG       NextWmiRegInfo;
  ULONG       RegistryPath;
  ULONG       MofResourceName;
  ULONG       GuidCount;
  WMIREGGUIDW WmiRegGuid[];
} WMIREGINFOW, *PWMIREGINFOW;

Anggota

BufferSize

Menunjukkan ukuran total data pendaftaran WMI yang terkait dengan struktur WMIREGINFO ini, dihitung sebagai berikut: (sizeof(WMIREGINFO) + (GuidCount * sizeof(WMIREGGUID) + additionaldata). Data tambahan mungkin menyertakan item seperti nama sumber daya MOF, jalur registri, dan nama instans statis untuk blok.

NextWmiRegInfo

Jika driver menangani permintaan WMI atas nama driver lain, sebagai driver kelas mungkin atas nama driver miniclass, NextWmiRegInfo menunjukkan offset dalam byte dari awal WMIREGINFO ini ke struktur WMIREGINFO berikutnya yang berisi informasi pendaftaran WMI untuk driver lain. Jika tidak, NextWmiRegInfo adalah nol.

RegistryPath

Menunjukkan offset dalam byte dari awal struktur ini ke string Unicode terhitung yang menentukan jalur registri yang diteruskan ke rutinitas DriverEntry driver. String harus diratakan pada batas USHORT. Anggota ini harus ditetapkan hanya sebagai respons terhadap permintaan pendaftaran WMI (IRP_MN_REGINFO atau IRP_MN_REGINFO_EX dengan Parameters.WMI.DataPath diatur ke WMIREGISTER).

MofResourceName

Menunjukkan offset dalam byte dari awal struktur ini ke string Unicode yang dihitung yang menentukan nama sumber daya MOF dalam file gambar driver. String harus diratakan pada batas USHORT. Anggota ini harus ditetapkan hanya sebagai respons terhadap permintaan pendaftaran WMI (IRP_MN_REGINFO atau IRP_MN_REGINFO_EX dengan Parameters.WMI.DataPath diatur ke WMIREGISTER).

GuidCount

Menunjukkan jumlah struktur WMIREGGUID dalam array di WmiRegGuid.

WmiRegGuid

Adalah array struktur GuidCount WMIREGGUID .

Keterangan

Menanggapi permintaan pendaftaran (IRP_MN_REGINFO atau IRP_MN_REGINFO_EX dengan Parameters.WMI.DataPath yang diatur ke WMIREGISTER), driver membangun setidaknya satu struktur WMIREGINFO dan menulis struktur WMIREGINFO ke buffer di IrpStack-Parameters.WMI.Buffer>. Struktur WMIREGINFO berisi array struktur WMIREGGUID , satu untuk setiap blok data atau blok peristiwa yang diekspos oleh driver.

Jika driver menangani permintaan WMI atas nama driver lain, driver membangun WMIREGINFO lain yang berisi array struktur WMIREGGUID untuk setiap blok yang diekspos oleh driver lain, mengatur anggota NextWmiRegInfo dari WMIREGINFO pertama ke offset dalam byte dari awal WMIREGINFO pertama ke awal WMIREGINFO berikutnya di buffer, dan menulis kedua struktur ke buffer. Driver menunjukkan ukuran total struktur WMIREGINFO dan data terkait saat memanggil IoCompleteRequest untuk menyelesaikan IRP.

Driver dapat menggunakan struktur WMIREGINFO yang sama untuk menghapus atau memperbarui blok sebagai respons terhadap permintaan pembaruan (IRP_MN_REGINFO atau IRP_MN_REGINFO_EX dengan Parameters.WMI.DataPath diatur ke WMIUPDATE). Jika WMIREG_FLAG_REMOVE_GUID diatur dalam anggota BenderaWMIREGGUID, WMI akan menghapus blok tersebut dari daftar blok yang sebelumnya didaftarkan oleh driver. Jika WMIREG_FLAG_REMOVE_GUID jelas, WMI memperbarui informasi pendaftaran untuk blok tersebut hanya jika anggota WMIREGGUID lain telah berubah—jika tidak, WMI tidak berubah menjadi informasi pendaftarannya untuk blok tersebut.

Persyaratan

Persyaratan	Nilai
Header	wmistr.h (termasuk Wmistr.h)

Lihat juga

Bagikan melalui