pcwUnregister 函数 (wdm.h)

  • 项目

函数 PcwUnregister 关闭指定的计数器集注册。 大多数开发人员将使用 CTRPP 生成的 UnregisterXxx 函数，而不是直接调用此函数。

语法

void PcwUnregister(
  PPCW_REGISTRATION Registration
);

参数

Registration

[in 指向正在关闭的注册的指针。

返回值

无

备注

函数 PcwUnregister 关闭指定的计数器集注册。 计数器集注册拥有的实例会自动关闭。 在取消注册计数器集或取消注册计数器集后，提供程序不应访问这些实例。

在提供程序使用此函数之前，提供程序必须调用 PcwRegister 函数来创建注册。

CTRPP 生成的 UnregisterXxx 函数

大多数开发人员不需要直接调用 PcwUnregister 。 相反，他们将使用 CTRPP 工具编译清单，并使用 CTRPP 生成的标头中的 UnregisterXxx 函数。 生成的函数如下所示：

EXTERN_C FORCEINLINE VOID
UnregisterMyCounterset(
    VOID
    )
{
    PAGED_CODE();

    PcwUnregister(MyCounterset);
}

CTRPP 生成的 Unregister 函数将命名为 PrefixUnregisterCounterSet。 前缀 通常为空，但如果在 CTRPP 命令行上使用参数， -prefix 则可能是存在的。 CounterSet 是清单中指定的计数器集的名称。 请注意， 函数引用) 示例中 (MyCounterset 计数器集变量，该变量是一个全局变量，保存由 CTRPP 生成的 RegisterXxx 函数初始化的计数器集注册句柄。

要求

要求 值
最低受支持的客户端 在 Windows 7 和更高版本的 Windows 中可用。
目标平台 通用
标头 wdm.h (包括 Wdm.h、Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL IRQL <= APC_LEVEL

另请参阅

PcwRegister 函数