PCW_CALLBACK_TYPE-Enumeration (wdm.h)

Die PCW_CALLBACK_TYPE Enumeration definiert den Typ der Benachrichtigung, die vom System an die vom Anbieter definierte PCW_CALLBACK-Funktion gesendet wird. Das System übergibt einen Wert dieser Enumeration im Type -Parameter des Rückrufs.

Syntax

typedef enum _PCW_CALLBACK_TYPE {
  PcwCallbackAddCounter,
  PcwCallbackRemoveCounter,
  PcwCallbackEnumerateInstances,
  PcwCallbackCollectData
} PCW_CALLBACK_TYPE, *PPCW_CALLBACK_TYPE;

Konstanten

PcwCallbackAddCounter Das System ruft den Rückruf des Anbieters mit diesem Type Wert auf, um den Anbieter darüber zu benachrichtigen, dass ein Consumer einer Abfrage, die diese Counterset enthält, einen instance Filter hinzugefügt hat. Die meisten Anbieter ignorieren Benachrichtigungen mit dieser Type, aber einige verwenden diese Benachrichtigung möglicherweise, um ihre Datensammlung zu optimieren. Beispielsweise kann InterlockedIncrement ein Anbieter einen globalen Leistungsindikator für jede AddCounter-Benachrichtigung erstellen und Leistungsdaten nur nachverfolgen, wenn der globale Leistungsindikator ungleich 0 (null) ist.
PcwCallbackRemoveCounter Das System ruft den Rückruf des Anbieters mit diesem Type Wert auf, um den Anbieter darüber zu informieren, dass ein Consumer einen instance Filter aus einer Abfrage entfernt hat, die diese Leistungsmenge enthält. Die meisten Anbieter ignorieren Benachrichtigungen mit dieser Type, aber einige verwenden diese Benachrichtigung möglicherweise, um ihre Datensammlung zu optimieren. Beispielsweise kann InterlockedDecrement ein Anbieter einen globalen Leistungsindikator für jede RemoveCounter-Benachrichtigung erstellen und Leistungsdaten nur nachverfolgen, wenn der globale Indikator ungleich 0 (null) ist.
PcwCallbackEnumerateInstances Das System ruft den Rückruf des Anbieters mit diesem Type Wert auf, um den Anbieter anzufordern, die Werte für Name und ID für die Instanzen des Countersets anzugeben. Die meisten Anbieter verwenden dieselbe Implementierung für PcwCallbackEnumerateInstances- und PcwCallbackCollectData-Benachrichtigungen, aber einige können die Datensammlung optimieren, indem die Sammlung von Zählerdatenwerten übersprungen wird, wenn auf einen PcwCallbackEnumerateInstances-Rückruf reagiert wird.
PcwCallbackCollectData Das System ruft den Rückruf des Anbieters mit diesem Type Wert auf, um den Anbieter anzufordern, die Werte für Name, ID und Zählerdaten für die Instanzen des Indikatorsatzes anzugeben. Ausführliche Informationen und Beispiele für die Behandlung dieser Benachrichtigung finden Sie in der Dokumentation für die funktion "PCW_CALLBACK ".

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Kopfzeile	wdm.h (include Wdm.h, Ntddk.h)

Weitere Informationen

rückruffunktion PCW_CALLBACK