共用方式為

CounterInitialize 函式

  • 發行項

註冊提供者並初始化計數器集合。

語法

ULONG WINAPI CounterInitialize(void);

參數

此函式沒有參數。

傳回值

傳回成功時ERROR_SUCCESS;否則為標準 Win32 錯誤碼。

備註

您的提供者會呼叫此函式。 函式包含對 PerfStartProvider 函式和 PerfSetCounterSetInfo 函式的呼叫。

當您指定-o引數時，CTRPP工具會產生此內嵌函式。 如果您指定-prefix引數，函式的名稱會包含前置詞字串。

如果您指定-MemoryRoutines或-NotificationCallback引數 (或指定提供者元素的回呼屬性) ，CounterInitialize簽章會變更為下列各項：

ULONG WINAPI CounterInitialize(
    __in_opt PERFLIBREQUEST NotificationCallback,
    __in_opt PERF_MEM_ALLOC MemoryAllocationFunction,
    __in_opt PERF_MEM_FREE MemoryFreeFunction,
    __inout_opt PVOID MemoryFunctionContext
);

其中

NotificationCallback

您實作的 ControlCallback 回 呼函式名稱，以接收取用者要求的通知 (，例如，要從查詢) 新增或移除計數器的要求。 如果您未實作ControlCallback 回呼函式，請將 設定為Null。

MemoryAllocationFunction

PERFLIB 呼叫以配置記憶體的 AllocateMemory 回呼函式名稱。 如果您未指定-MemoryRoutines引數，請將 設定為Null。

MemoryFreeFunction

PERFLIB 呼叫的 FreeMemory 回呼函式名稱，以釋放使用 AllocateMemory 函式配置的記憶體。 如果MemoryAllocationFunction為 Null，請將 設定為Null。

MemoryFunctionCoNtext

要傳遞至記憶體配置和釋放常式的內容資訊。 可以是 Null。

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 R2 [僅限傳統型應用程式]