WmiCompleteRequest 函式 (wmilib.h)

發行項
02/27/2024

WmiCompleteRequest 例程指出驅動程式已完成處理 DpWmiXxx 例程中的 WMI 要求。

語法

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

參數

[in] DeviceObject

驅動程式 DEVICE_OBJECT的指標。

[in, out] Irp

IRP 的指標。

[in] Status

指定要針對 IRP 傳回的狀態。

[in] BufferUsed

指定傳遞至驅動程式 DpWmiXxx 例程之緩衝區中所需的位元元組數目。如果緩衝區太小，驅動程式會將 Status 設定為STATUS_BUFFER_TOO_SMALL，並將 BufferUsed 設定為傳回數據所需的位元組數目。如果傳遞的緩衝區夠大，驅動程式會將 BufferUsed 設定為實際使用的位元元組數目。

[in] PriorityBoost

指定系統定義的常數，以遞增要求作業之原始線程的運行時間優先順序。 WMI 會在 IRP 完成時，使用 PriorityBoost 呼叫 IoCompleteRequest。如需 PriorityBoost 的詳細資訊，請參閱 IoCompleteRequest。

傳回值

WmiCompleteRequest 會傳回在 Status 參數中傳遞給它的值，除非 Status 設定為 STATUS_BUFFER_TOO_SMALL。如果驅動程式將 Status 設定為 STATUS_BUFFER_TOO_SMALL，WmiCompleteRequest 會建置WNODE_TOO_SMALL結構，並傳回STATUS_SUCCESS。 來自 WmiCompleteRequest 的傳回值應該由驅動程式在其 DpWmiXxx 例程中傳回。

備註

驅動程式從 DpWmiXxx 例程呼叫 WmiCompleteRequest 之後，在該例程中完成所有其他處理，或在驅動程式完成擱置 IRP 的所有處理之後。 WmiCompleteRequest 會以驅動程式傳回的任何數據填入 WNODE_XXX ，並呼叫 IoCompleteRequest 來完成 IRP。

驅動程序應該一律在其 DpWmiXxx 例程中傳回 WmiCompleteRequest 的傳回值。

驅動程式不得從其 DpWmiQueryRegInfo 例程呼叫 WmiCompleteRequest。

規格需求

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wmilib.h (包含 Wmilib.h)
程式庫	Wmilib.lib
IRQL	<= DISPATCH_LEVEL