通过

WMI_SET_DATABLOCK_CALLBACK回调函数 （wmilib.h）

  • 项目

DpWmiSetDataBlock 例程更改数据块的单个实例中的所有数据项。 此例程是可选的。

语法

WMI_SET_DATABLOCK_CALLBACK WmiSetDatablockCallback;

NTSTATUS WmiSetDatablockCallback(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP Irp,
  [in] ULONG GuidIndex,
  [in] ULONG InstanceIndex,
  [in] ULONG BufferSize,
  [in] PUCHAR Buffer
)
{...}

参数

[in] DeviceObject

指向驱动程序的 WDM DEVICE_OBJECT 结构的指针。

[in] Irp

指向 IRP 的指针。

[in] GuidIndex

通过将数据块从零开始的索引指定到传递给 WmiSystemControl 的 WMILIB_CONTEXT结构中驱动程序提供的 GUID 列表。

[in] InstanceIndex

如果由 GuidIn dex 指定的块具有多个实例，InstanceIndex 指定实例。

[in] BufferSize

指定缓冲区 缓冲区的大小（以字节为单位）。

[in] Buffer

指向包含实例新值的缓冲区的指针。

返回值

DpWmiSetDataBlock 返回STATUS_SUCCESS或相应的错误状态，如下所示：

如果驱动程序无法立即完成请求，它可以返回STATUS_PENDING。

言论

在驱动程序调用 WmiSystemControl 响应 IRP_MN_CHANGE_SINGLE_INSTANCE 请求后，WMI 调用驱动程序的 DpWmiSetDataBlock 例程。

驱动程序负责验证所有输入参数。 具体而言，驱动程序必须执行以下作：

  • 根据 WMILIB_CONTEXT 结构的 GuidCount 成员，验证 GuidIndex 值是否介于零和 GuidCount-1 之间。
  • 验证驱动程序是否已标记指定的数据块以供删除。 如果驱动程序最近在 WMIGUIDREGINFO 中指定了WMIREG_FLAG_REMOVE_GUID标志 结构（包含在 WMILIB_CONTEXT 结构中），则设置请求可以在删除发生前到达。
  • 验证 InstanceIndex 值是否在数据块驱动程序支持的实例索引范围内。
  • 验证 Buffer 和 BufferSize 描述有效大小的数据块，包括数据项之间存在的任何填充，以及缓冲区的内容是否对数据块有效。
  • 验证指定的数据块是否是驱动程序允许调用方发起的修改的块。 换句话说，驱动程序不应允许修改你打算只读的数据块。
不要假设线程上下文是发起的用户模式应用程序，更高级别的驱动程序可能已更改它。

如果驱动程序实现 DpWmiSetDataBlock 例程，驱动程序必须将例程的地址放置在 SetWmiDataBlockWMILIB_CONTEXT 结构的成员中，该结构传递给 WmiSystemControl。 如果驱动程序未实现 DpWmiSetDataBlock 例程，则必须 将 setWmiDataBlock 设置为 NULL。 在后一种情况下，WMI 将STATUS_READ_ONLY返回到调用方。

此例程可以分页。

有关实现此例程的详细信息，请参阅 调用 WmiSystemControl 来处理 WMI IRP。

要求

要求 价值
目标平台 桌面
标头 wmilib.h （包括 Wmilib.h）
IRQL 在PASSIVE_LEVEL调用。

另请参阅

IRP_MN_CHANGE_SINGLE_INSTANCE

WMILIB_CONTEXT

WmiSystemControl