PERFLIBREQUEST 回調函式（perflib.h）

提供者可以實作此功能，當消費者執行特定動作時，例如新增或移除查詢中的計數器，接收通知。 PERFLIB 會在消費者的請求完成前呼叫回調。

PERFLIBREQUEST 型別定義了指向此回調函式的指標。 ControlCallback 函式是應用程式定義函式名稱的佔位符。

語法

PERFLIBREQUEST Perflibrequest;

ULONG Perflibrequest(
  [in] ULONG RequestCode,
  [in] PVOID Buffer,
  [in] ULONG BufferSize
)
{...}

參數

[in] RequestCode

請求碼可以是以下其中一種值。

[in] Buffer

緩衝區的內容取決於請求本身。 關於可能的內容，請參見 RequestCode 參數。

[in] BufferSize

緩 衝 區參數的大小，以位元組為單位。

返回值

如果回撥成功，請回ERROR_SUCCESS。

若回調失敗，PERFLIB 會在請求為 PERF_ADD_COUNTER、 PERF_ENUM_INSTANCES 或 PERF_COLLECT_START 時將錯誤碼回傳給消費者;否則，錯誤代碼將被忽略。

備註

如果提供者元素的 callback 屬性是「自訂」的，或你在呼叫 CTRPP 時使用 -NotificationCallback 參數，你必須實作這個函式。 你把回調函式的名稱傳給 CounterInitialize。

Windows Vista： CounterInitialize 函式被命名為 PerfAutoInitialize。 CTRPP 工具也會為你產生包含所有請求碼的回撥骨架。 接著你把想要支援的請求碼加進去，其他的則是移除。

回撥必須在一秒內完成。 若回調未及時完成，PERFLIB 會繼續執行消費者請求，並忽略回調完成時的回傳值。

範例

以下範例展示了 ControlCallback 函式的簡單實作。

ULONG MyControlCallback(ULONG RequestCode, PVOID pBuffer, ULONG* pBufferSize)
{
    ULONG Status = ERROR_SUCCESS;
    PWNODE_HEADER Wnode = (PWNODE_HEADER)pBuffer;
    LPWSTR pComputerName = NULL;
    LPWSTR pInstance = NULL;
    PPERF_COUNTER_IDENTITY pCounter;
    UNREFERENCED_PARAMETER(pBufferSize);

    switch (RequestCode) 
    {
        case PERF_ADD_COUNTER:
            pCounter = (PPERF_COUNTER_IDENTITY)(((LPBYTE) Wnode) + sizeof(WNODE_HEADER));
            pComputerName = (LPWSTR)(((LPBYTE) pCounter) + pCounter->MachineOffset);
            pInstance = (pCounter->NameOffset > 0) 
                ? (LPWSTR) (((LPBYTE) pCounter) + pCounter->NameOffset) : NULL;
            
            break;

        case PERF_REMOVE_COUNTER: 
            pCounter = (PPERF_COUNTER_IDENTITY)(((LPBYTE) Wnode) + sizeof(WNODE_HEADER));
            pComputerName = (LPWSTR)(((LPBYTE) pCounter) + pCounter->MachineOffset);
            pInstance = (pCounter->NameOffset > 0)
                ? (LPWSTR) (((LPBYTE) pCounter) + pCounter->NameOffset) : NULL;
            
            break;

        case PERF_ENUM_INSTANCES:
            pComputerName = (LPWSTR) (((LPBYTE) Wnode) + sizeof(WNODE_HEADER));
            
            break;

        case PERF_COLLECT_START: 
            pComputerName = (LPWSTR) (((LPBYTE) Wnode) + sizeof(WNODE_HEADER));
            
            break;

        case PERF_COLLECT_END: 
            pComputerName = (LPWSTR) (((LPBYTE) Wnode) + sizeof(WNODE_HEADER));
            
            break;

        default:
            wprintf(L"Unknown request code, %lu\n", RequestCode);
    }

    return Status;
}

需求