EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD回呼函式（wdfwmi.h）

發行項
02/07/2025

[僅適用於 KMDF]

驅動程式的 EvtWmiInstanceExecuteMethod 回呼函式會執行驅動程式為 WMI 數據提供者實例提供的指定方法。

語法

EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD EvtWdfWmiInstanceExecuteMethod;

NTSTATUS EvtWdfWmiInstanceExecuteMethod(
  [in]      WDFWMIINSTANCE WmiInstance,
  [in]      ULONG MethodId,
  [in]      ULONG InBufferSize,
  [in]      ULONG OutBufferSize,
  [in, out] PVOID Buffer,
  [out]     PULONG BufferUsed
)
{...}

參數

[in] WmiInstance

WMI 實例物件的句柄。

[in] MethodId

值，識別提供者實例中的方法。這個值對應於提供者MOF檔案中指定的 WmiMethodId 值。

[in] InBufferSize

輸入數據的位元組數目。

[in] OutBufferSize

緩衝區可以保存的輸出數據位元組數目。

[in, out] Buffer

用於輸入、輸出或兩者之緩衝區的指標，由指定的方法決定。如果同時提供輸入和輸出數據，驅動程式就會使用輸出數據覆寫輸入數據。

[out] BufferUsed

位置的指標，接收驅動程式寫入輸出緩衝區的位元元組數目。如果輸出緩衝區大小 OutBufferSize 參數指定太小，驅動程式會將此位置設定為所需的緩衝區大小。

傳回值

如果作業成功，EvtWmiInstanceExecuteMethod 回呼函式必須傳回STATUS_SUCCESS。否則，此函式必須傳回狀態值，NT_SUCCESS狀態）等於 FALSE。如果 outBufferSize 參數的值表示輸出緩衝區太小而無法接收數據，則驅動程式必須傳回STATUS_BUFFER_TOO_SMALL。