共用方式為

PcwUnregister 函式 (wdm.h)

  • 發行項

函 PcwUnregister 式會關閉指定的計數器集註冊。 大部分開發人員都會使用 CTRPP 產生的 UnregisterXxx 函式，而不是直接呼叫此函式。

語法

void PcwUnregister(
  PPCW_REGISTRATION Registration
);

參數

Registration

[在要關閉之註冊的指標中。

傳回值

無

備註

函 PcwUnregister 式會關閉指定的計數器集註冊。 計數器集註冊所擁有的實例會自動關閉。 當計數器集正在取消註冊或計數器集取消註冊之後，提供者不應該存取這些實例。

在提供者使用此函式之前，提供者必須呼叫 PcwRegister 函式來建立註冊。

CTRPP 產生的 UnregisterXxx 函式

大部分開發人員不需要直接呼叫 PcwUnregister 。 相反地，他們會使用 CTRPP 工具編譯指令清單，並使用來自 CTRPP 產生的標頭的 UnregisterXxx 函式。 產生的函式看起來會像這樣：

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

    PcwUnregister(MyCounterset);
}

CTRPP 產生的 Unregister 函式會命名為 PrefixUnregisterCounterSet。 前置 詞通常為空白，但如果在 CTRPP 命令行上使用參數，則可能存在 -prefix 。 CounterSet 是計數器集的名稱，如指令清單中所指定。 請注意，函式會在範例) 中參考 Counterset 變數 (MyCounterset ，這是保存 CTRPP 產生 RegisterXxx 函式所初始化之計數器集註冊句柄的全域變數。

規格需求

需求 值
最低支援的用戶端 可在 Windows 7 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL IRQL <= APC_LEVEL

另請參閱

PcwRegister 函式