Fungsi WmiCompleteRequest (wmilib.h)

Artikel
02/27/2024

Rutinitas WmiCompleteRequest menunjukkan bahwa driver telah selesai memproses permintaan WMI dalam rutinitas DpWmiXxx .

Sintaks

NTSTATUS WmiCompleteRequest(
  [in]      PDEVICE_OBJECT DeviceObject,
  [in, out] PIRP           Irp,
  [in]      NTSTATUS       Status,
  [in]      ULONG          BufferUsed,
  [in]      CCHAR          PriorityBoost
);

Parameter

[in] DeviceObject

Penunjuk ke DEVICE_OBJECT pengemudi.

[in, out] Irp

Penunjuk ke IRP.

[in] Status

Menentukan status yang akan dikembalikan untuk IRP.

[in] BufferUsed

Menentukan jumlah byte yang diperlukan dalam buffer yang diteruskan ke rutinitas DpWmiXxx driver. Jika buffer terlalu kecil, driver mengatur Status ke STATUS_BUFFER_TOO_SMALL dan mengatur BufferUsed ke jumlah byte yang diperlukan agar data dikembalikan. Jika buffer yang diteruskan cukup besar, driver mengatur BufferUsed ke jumlah byte yang benar-benar digunakan.

[in] PriorityBoost

Menentukan konstanta yang ditentukan sistem untuk menaikkan prioritas run-time dari utas asli yang meminta operasi. WMI memanggil IoCompleteRequest dengan PriorityBoost saat menyelesaikan IRP. Lihat IoCompleteRequest untuk informasi selengkapnya tentang PriorityBoost.

Nilai kembali

WmiCompleteRequest mengembalikan nilai yang diteruskan ke dalam parameter Status kecuali Status diatur ke STATUS_BUFFER_TOO_SMALL. Jika driver mengatur Status sama dengan STATUS_BUFFER_TOO_SMALL, WmiCompleteRequest menyusun struktur WNODE_TOO_SMALL dan mengembalikan STATUS_SUCCESS. Nilai yang dikembalikan dari WmiCompleteRequest harus dikembalikan oleh driver dalam rutinitas DpWmiXxx .

Keterangan

Driver memanggil WmiCompleteRequest dari rutinitas DpWmiXxx setelah menyelesaikan semua pemrosesan lain dalam rutinitas tersebut, atau setelah driver menyelesaikan semua pemrosesan untuk IRP yang tertunda. WmiCompleteRequest mengisi WNODE_XXX dengan data apa pun yang dikembalikan oleh driver dan memanggil IoCompleteRequest untuk menyelesaikan IRP.

Driver harus selalu mengembalikan nilai yang dikembalikan dari WmiCompleteRequest dalam rutinitas DpWmiXxx .

Driver tidak boleh memanggil WmiCompleteRequest dari rutinitas DpWmiQueryRegInfo .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Target Platform	Universal
Header	wmilib.h (termasuk Wmilib.h)
Pustaka	Wmilib.lib
IRQL	<= DISPATCH_LEVEL