EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD回调函数 (wdfwmi.h)

项目
08/08/2023

[仅适用于 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。