驱动程序定义的 WMI 数据项

Myth丶恋晨 2023-10-01 20:28 7阅读 0赞

WMI 数据或事件块的类定义中的数据项可以是下列项之一：

*  基本数据类型，如字符串或无符号整数。
 *  嵌入的类。 嵌入类仅用作另一个类定义中的数据项，不作为数据块或事件块公开。
 *  基本数据类型或嵌入类的固定长度或可变长度数组。

将数据块发送到 WMI 时，驱动程序必须在 8 字节边界上对齐块的起始点。 块中所有后续数据项都必须与数据类型的相应对齐方式对齐。 **布尔值或****uint8**应在 1 字节边界上对齐。 **sint16、uint16**或**字符串**项应在 2 字节边界上对齐，等等。 数组应基于数组的基类型对齐。 字节数组应在字节边界上对齐，uint64 数组应在 8 字节边界上对齐，等等。 嵌入类应基于嵌入类的自然对齐方式进行对齐，该对齐方式定义为嵌入类中的最大元素。 例如，如果嵌入的类具有 **uint64**，则类应在 8 字节边界上对齐。 WMI 数据项对齐遵循与 Microsoft C 编译器 **上的 /Zp8** 开关相同的约定。

驱动程序编写器不一定要在块中定义数据项，所需项为 **InstanceName** 和 **Active**。 例如，空事件块可以充当事件发生的通知，而无需其他数据。 或者，数据块可能只枚举实例名称以响应[IRP\_MN\_QUERY\_ALL\_DATA请求。][IRP_MN_QUERY_ALL_DATA]

下表列出了可用于定义 WMI 数据或事件块中的项的 MOF 数据类型。 有关 MOF 数据类型的信息，请参阅 Microsoft Windows SDK。

<table> 表 1 
 <thead> 
 <tr> 
 <th>数据类型</th> 
 <th>数据格式</th> 
 <th>对齐 (字节数)</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> string </td> 
 <td> 一个 USHORT，指定字符串长度（以字节为单位）后跟 Unicode 字符串数据。 字符串数据可以选择包括终止 0，后跟填充。 如果是这样，则字符串长度必须包含终止 0 和填充。 驱动程序可以使用&nbsp;MaxLen&nbsp;限定符指定字符串的最大长度（以字符表示）。 指定最大字符串长度的驱动程序可以使用固定大小的缓冲区来保存字符串。 如果字符串严格小于缓冲区的大小，则驱动程序可以使用零填充字符串的其余部分。 </td> 
 <td> 2 </td> 
 </tr> 
 <tr> 
 <td> boolean </td> 
 <td> 一个单字节值，其中 0 为 FALSE，任何非零值为 TRUE </td> 
 <td> 1 </td> 
 </tr> 
 <tr> 
 <td> sint8 </td> 
 <td> 8 位带符号整数 </td> 
 <td> 1 </td> 
 </tr> 
 <tr> 
 <td> uint8 </td> 
 <td> 无符号的 8 位整数 </td> 
 <td> 1 </td> 
 </tr> 
 <tr> 
 <td> sint16 </td> 
 <td> 有符号 16 位整数 </td> 
 <td> 2 </td> 
 </tr> 
 <tr> 
 <td> uint16 </td> 
 <td> 无符号 16 位整数 </td> 
 <td> 2 </td> 
 </tr> 
 <tr> 
 <td> sint32 </td> 
 <td> 带符号的 32 位整数 </td> 
 <td> 4 </td> 
 </tr> 
 <tr> 
 <td> uint32 </td> 
 <td> 无符号的 32 位整数 </td> 
 <td> 4 </td> 
 </tr> 
 <tr> 
 <td> sint64 </td> 
 <td> 64 位带符号整数 </td> 
 <td> 8 </td> 
 </tr> 
 <tr> 
 <td> uint64 </td> 
 <td> 无符号 64 位整数 </td> 
 <td> 8 </td> 
 </tr> 
 <tr> 
 <td> datetime </td> 
 <td> 一个固定长度为 25 个字符的 Unicode 字符串，指定绝对日期或时间间隔。&nbsp;datetime值采用以下格式： yyyymmddhhmmss.mmmmmmsutc 其中： yyyy 是&nbsp;4 位数年份 mm&nbsp;是 2 位数月份 dd&nbsp;是一个月的 2 位数天 hh&nbsp;是 24 小时制的小时 mm&nbsp;是分钟 ss&nbsp;为秒 mmmmmm&nbsp;是微秒数 s&nbsp;是 + () 或减号 (-) ，指示&nbsp;utc&nbsp;是相对于通用时间坐标的正偏移量还是负偏移量;或冒号 (：) ，指示&nbsp;datetime&nbsp;值为间隔。 utc&nbsp;是相对于通用时间坐标的偏移量（以分钟表示）。 如果&nbsp;utc&nbsp;为零 (000) ，&nbsp;则 datetime&nbsp;值为间隔。 值必须为零填充。 不重要的字段可以使用星号 (*) 。 </td> 
 </tr> 
 </tbody> 
</table>

[IRP_MN_QUERY_ALL_DATA]: https://docs.microsoft.com/zh-cn/windows-hardware/drivers/kernel/irp-mn-query-all-data