perflib.h header

This header is used by Performance Counters. For more information, see:

• Performance Counters

perflib.h contains the following programming interfaces:

Functions

PerfAddCounters Adds performance counter specifications to the specified query.
PerfCloseQueryHandle Closes a query handle that you opened by calling PerfOpenQueryHandle.
PerfCreateInstance Creates an instance of the specified counter set.
PerfDecrementULongCounterValue Decrements the value of a counter whose value is a 4-byte unsigned integer. Providers use this function.
PerfDecrementULongLongCounterValue Decrements the value of a counter whose value is an 8-byte unsigned integer. Providers use this function.
PerfDeleteCounters Removes the specified performance counter specifications from the specified query.
PerfDeleteInstance Deletes an instance of the counter set created by the PerfCreateInstance function.
PerfEnumerateCounterSet Gets the counter set identifiers of the counter sets that are registered on the specified system. Counter set identifiers are globally unique identifiers (GUIDs).
PerfEnumerateCounterSetInstances Gets the names and identifiers of the active instances of a counter set on the specified system.
PerfIncrementULongCounterValue Increments the value of a counter whose value is a 4-byte unsigned integer. Providers use this function.
PerfIncrementULongLongCounterValue Increments the value of a counter whose value is an 8-byte unsigned integer. Providers use this function.
PerfOpenQueryHandle Creates a handle that references a query on the specified system. A query is a list of counter specifications.
PerfQueryCounterData Gets the values of the performance counters that match the counter specifications in the specified query.
PerfQueryCounterInfo Gets the counter specifications in the specified query.
PerfQueryCounterSetRegistrationInfo Gets information about a counter set on the specified system.
PerfQueryInstance Retrieves a pointer to the specified counter set instance. Providers use this function.
PerfSetCounterRefValue Updates the value of a counter whose value is a pointer to the actual data. Providers use this function.
PerfSetCounterSetInfo Specifies the layout of a particular counter set.
PerfSetULongCounterValue Updates the value of a counter whose value is a 4-byte unsigned integer. Providers use this function.
PerfSetULongLongCounterValue Updates the value of a counter whose value is an 8-byte unsigned integer. Providers use this function.
PerfStartProvider Registers the provider. (PerfStartProvider)
PerfStartProviderEx Registers the provider. (PerfStartProviderEx)
PerfStopProvider Removes the provider's registration from the list of registered providers and frees all resources associated with the provider.

Callback functions

PERF_MEM_ALLOC Providers implement this function to provide custom memory management for PERFLIB.A
PERF_MEM_FREE Providers implement this function to provide custom memory management for PERFLIB.F
PERFLIBREQUEST Providers can implement this function to receive notification when consumers perform certain actions, such as adding or removing counters from a query.

Structures

PERF_COUNTER_DATA Contains information about the PERF_COUNTER_DATA block that contains the structure.
PERF_COUNTER_HEADER Contains information about the PERF_COUNTER_HEADER block that contains the structure.
PERF_COUNTER_IDENTIFIER Contains information about the PERF_COUNTER_IDENTIFIER block that contains the structure.
PERF_COUNTER_IDENTITY Defines the counter that is sent to a provider's callback when the consumer adds or removes a counter from the query.
PERF_COUNTER_INFO Defines information about a counter that a provider uses. The CTRPP tool automatically generates this structure based on the schema you specify.
PERF_COUNTER_REG_INFO Provides registration information about a performance counter.
PERF_COUNTERSET_INFO Defines information about a counter set that a provider uses. The CTRPP tool automatically generates this structure based on the schema you specify.
PERF_COUNTERSET_INSTANCE Defines an instance of a counter set.
PERF_COUNTERSET_REG_INFO Contains information about the PERF_COUNTERSET_REG_INFO block that contains the structure.
PERF_DATA_HEADER Provides information about the PERF_DATA_HEADER block that contains the structure.
PERF_INSTANCE_HEADER Provides information about the PERF_INSTANCE_HEADER block that contains the structure.
PERF_MULTI_COUNTERS Provides information about the PERF_MULTI_COUNTERS block that contains the structure.
PERF_MULTI_INSTANCES Provides information about the PERF_MULTI_INSTANCES block that contains the structure.
PERF_PROVIDER_CONTEXT Defines provider context information.
PERF_STRING_BUFFER_HEADER Provides information about the PERF_STRING_BUFFER_HEADER block that contains the structure.
PERF_STRING_COUNTER_HEADER Indicates where in the PERF_STRING_BUFFER_HEADER block that the string that contains the name or help string for the indicated performance counter starts.

Enumerations

PerfCounterDataType Indicates the content type of a PERF_COUNTER_HEADER block that the PerfQueryCounterData function includes as part of the PERF_DATA_HEADER block that the function produces as output.
PerfRegInfoType Indicates the types of information that you can request about a performance counter set by calling the PerfQueryCounterSetRegistrationInfo function.