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

Buffer 매개 변수의 크기(바이트)입니다.

반환 값

콜백이 성공하면 ERROR_SUCCESS 반환합니다.

콜백에 실패하면 요청이 PERF_ADD_COUNTER, PERF_ENUM_INSTANCES 또는PERF_COLLECT_START; 인 경우 PERFLIB가 오류 코드를 소비자에게 반환합니다. 그렇지 않으면 오류 코드가 무시됩니다.

비고

공급자 요소의 콜백 특성이 "custom"이거나 CTRPP를 호출할 때 -NotificationCallback 인수를 사용한 경우 이 함수를 구현해야 합니다. CounterInitialize에 콜백 함수의 이름을 전달합니다.

Windows Vista: CounterInitialize 함수의 이름은 PerfAutoInitialize입니다. 또한 CTRPP 도구는 모든 요청 코드를 포함하는 이 콜백의 구조를 생성합니다. 그런 다음 지원하려는 요청 코드에 코드를 추가하고 다른 코드를 제거합니다.

콜백은 1초 이내에 완료되어야 합니다. 콜백이 시간에 완료되지 않으면 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;
}

요구 사항