pcwCloseInstance 函数 (wdm.h)

函数 PcwCloseInstance 关闭使用 PcwCreateInstance 创建的计数器集实例。大多数开发人员将使用 CTRPP 生成的 CloseXxx 函数，而不是直接调用此函数。

语法

void PcwCloseInstance(
  [in] PPCW_INSTANCE Instance
);

[in] Instance

指向要关闭的计数器集实例的指针。

无

PcwCreateInstance使用函数创建计数器集实例。

如果已调用 PcwUnregister 进行相应的计数器集注册，则不能在实例上调用 PcwCloseInstance 。注销计数器集时，将为你关闭所有剩余的实例。再次关闭它们将使系统崩溃。

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

EXTERN_C FORCEINLINE VOID
CloseMyCounterset(
    __in PPCW_INSTANCE Instance
    )
{
    PAGED_CODE();

    PcwCloseInstance(Instance);
}

CTRPP 生成的 Close 函数将命名为 PrefixCloseCounterSet。前缀通常为空，但如果在 CTRPP 命令行上使用参数， -prefix 则可能存在前缀。 CounterSet 是清单中指定的计数器集的名称。