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 是計數器集的名稱，如指令清單中所指定。