(wdm.h) PCW_CALLBACK_TYPE 枚举

PCW_CALLBACK_TYPE枚举定义系统发送到提供程序定义的PCW_CALLBACK函数的通知的类型。 系统在回调的 参数中 Type 传递此枚举的值。

语法

typedef enum _PCW_CALLBACK_TYPE {
  PcwCallbackAddCounter,
  PcwCallbackRemoveCounter,
  PcwCallbackEnumerateInstances,
  PcwCallbackCollectData
} PCW_CALLBACK_TYPE, *PPCW_CALLBACK_TYPE;

常量

 
PcwCallbackAddCounter
系统使用此值 Type 调用提供程序的回调,以通知提供程序使用者已将实例筛选器添加到涉及此计数器集的查询。

大多数提供程序会忽略包含此 Type的通知,但有些提供程序可能会使用此通知来优化其数据收集。 例如,提供程序可能 InterlockedIncrement 为每个 AddCounter 通知提供全局计数器,并且仅在全局计数器为非零时跟踪性能数据。
PcwCallbackRemoveCounter
系统使用此值 Type 调用提供程序的回调,以通知提供程序使用者已从涉及此计数器集的查询中删除了实例筛选器。

大多数提供程序会忽略包含此 Type的通知,但有些提供程序可能会使用此通知来优化其数据收集。 例如,提供程序可能 InterlockedDecrement 为每个 RemoveCounter 通知提供全局计数器,并且仅在全局计数器为非零时跟踪性能数据。
PcwCallbackEnumerateInstances
系统使用此值 Type 调用提供程序的回调,以请求提供程序为计数器集的实例提供 Name 和 ID 值。

大多数提供程序对 PcwCallbackEnumerateInstances 和 PcwCallbackCollectData 通知使用相同的实现,但有些提供程序可能会在响应 PcwCallbackEnumerateInstances 回调时跳过计数器数据值的收集来优化数据收集。
PcwCallbackCollectData
系统使用此值 Type 调用提供程序的回调,以请求提供程序为计数器集的实例提供名称、ID 和计数器数据值。

有关处理此通知的详细信息和示例,请参阅 PCW_CALLBACK 函数的文档。

要求

要求
最低受支持的客户端 在 Windows 7 和更高版本的 Windows 中可用。
标头 wdm.h (包括 Wdm.h、Ntddk.h)

另请参阅

PCW_CALLBACK回调函数