EVT_WDF_WMI_INSTANCE_QUERY_INSTANCE fungsi panggilan balik (wdfwmi.h)

Artikel
08/08/2023

[Berlaku untuk KMDF saja]

Fungsi panggilan balik EvtWmiInstanceQueryInstance driver menyalin data instans penyedia WMI ke dalam buffer untuk pengiriman ke klien WMI.

Sintaks

EVT_WDF_WMI_INSTANCE_QUERY_INSTANCE EvtWdfWmiInstanceQueryInstance;

NTSTATUS EvtWdfWmiInstanceQueryInstance(
  [in]  WDFWMIINSTANCE WmiInstance,
  [in]  ULONG OutBufferSize,
  [in]  PVOID OutBuffer,
  [out] PULONG BufferUsed
)
{...}

Parameter

[in] WmiInstance

Handel ke objek instans WMI.

[in] OutBufferSize

Ukuran, dalam byte, dari buffer output yang dirujuk OutBuffer .

[in] OutBuffer

Penunjuk ke buffer output.

[out] BufferUsed

Penunjuk ke lokasi yang menerima jumlah byte yang ditempat driver di buffer output. Jika ukuran buffer output yang ditentukan parameter OutBufferSize terlalu kecil, driver mengatur lokasi ini ke ukuran buffer yang diperlukan.

Nilai kembali

Fungsi panggilan balik EvtWmiInstanceQueryInstance harus mengembalikan STATUS_BUFFER_TOO_SMALL, jika nilai parameter OutBufferSize menunjukkan bahwa buffer output terlalu kecil untuk menerima data. Jika tidak, fungsi panggilan balik harus menyalin data ke buffer dan mengembalikan STATUS_SUCCESS.

Keterangan

Untuk mendaftarkan fungsi panggilan balik EvtWmiInstanceQueryInstance , driver Anda harus menempatkan alamat fungsi dalam struktur WDF_WMI_INSTANCE_CONFIG sebelum memanggil WdfWmiInstanceCreate.

Sebelum kerangka kerja mengirim data instans yang disediakan driver ke klien WMI, kerangka kerja menambahkan semua informasi header WMI yang diperlukan ke data.

Jika driver Anda mengatur anggota UseContextForQuery dari struktur WDF_WMI_INSTANCE_CONFIG objek instans WMI ke TRUE untuk blok data baca-saja, driver tidak menyediakan fungsi panggilan balik EvtWmiInstanceQueryInstance .

Jika driver Anda harus memberikan data string ke klien WMI, driver harus memanggil fungsi WDF_WMI_BUFFER_APPEND_STRING untuk memformat string.

Untuk informasi selengkapnya tentang fungsi panggilan balik EvtWmiInstanceQueryInstance , lihat Mendukung Blok Data Baca/Tulis WMI dan Mendukung Blok Data Read-Only WMI.

Kerangka kerja tidak menyinkronkan panggilan ke fungsi panggilan balik peristiwa WMI driver satu sama lain atau dengan fungsi panggilan balik peristiwa lainnya dari driver. Jika data fungsi panggilan balik EvtWmiInstanceQueryInstance bersifat dinamis dan dibagikan dengan fungsi panggilan balik lainnya, driver Anda dapat menggunakan kunci tunggu kerangka kerja atau kunci putar untuk menyinkronkan akses ke data.

Untuk informasi selengkapnya tentang WMI, lihat Mendukung WMI di driver Framework-Based.