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

Buffer 可以容纳的缓冲区的输出数据的字节数。

[in, out] Buffer

指向用于输入、输出或两者（由指定方法确定）的缓冲区的指针。如果同时提供输入和输出数据，驱动程序将使用输出数据覆盖输入数据。

[out] BufferUsed

指向接收驱动程序写入到输出缓冲区中的字节数的位置的指针。如果 OutBufferSize 参数指定的输出缓冲区大小太小，驱动程序会将此位置设置为所需的缓冲区大小。

返回值

如果作成功，EvtWmiInstanceExecuteMethod 回调函数必须返回STATUS_SUCCESS。否则，此函数必须返回一个状态值，NT_SUCCESS（状态）等于 FALSE。如果 OutBufferSize 参数的值指示输出缓冲区太小而无法接收数据，驱动程序必须返回STATUS_BUFFER_TOO_SMALL。