Fungsi WdfWmiInstanceRegister (wdfwmi.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfWmiInstanceRegister mendaftarkan instans tertentu dari penyedia data WMI dengan layanan WMI sistem.

Sintaks

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

Parameter

[in] WmiInstance

Handel ke objek instans WMI yang diperoleh driver dari panggilan sebelumnya ke WdfWmiInstanceCreate.

Nilai kembali

WdfWmiInstanceRegister mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_INVALID_DEVICE_REQUEST
 Instans WMI yang ditentukan telah didaftarkan.
 

Metode ini juga dapat mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Instans penyedia tidak tersedia untuk klien WMI sampai telah terdaftar. Driver Anda harus memanggil WdfWmiInstanceRegister atau mengatur anggota Register dari struktur WDF_WMI_INSTANCE_CONFIG instans ke TRUE.

Untuk informasi selengkapnya tentang metode WdfWmiInstanceRegister , lihat Mendaftarkan Instans Penyedia. Untuk informasi selengkapnya tentang WMI, lihat Mendukung WMI di driver Framework-Based.

WdfWmiInstanceRegister mendaftarkan instans penyedia secara sinkron (yaitu, sebelum dikembalikan) jika dipanggil di IRQL = PASSIVE_LEVEL dan secara asinkron jika dipanggil di IRQL > PASSIVE_LEVEL.

Contoh

Contoh kode berikut mendaftarkan instans tertentu dari penyedia data WMI dengan layanan WMI sistem.

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdfwmi.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceBuat

WdfWmiInstanceDeregister