PCW_MASK_INFORMATION-Struktur (wdm.h)

Die PCW_MASK_INFORMATION -Struktur ist der Typ der EnumerateInstances Member und CollectData der _PCW_CALLBACK_INFORMATION Union. Sie enthält Details zu einer Benachrichtigung, die vom System an eine vom Anbieter definierte PCW_CALLBACK-Funktion gesendet wird.

Syntax

typedef struct _PCW_MASK_INFORMATION {
  ULONG64          CounterMask;
  PCUNICODE_STRING InstanceMask;
  ULONG            InstanceId;
  BOOLEAN          CollectMultiple;
  PPCW_BUFFER      Buffer;
  PKEVENT          CancelEvent;
} PCW_MASK_INFORMATION, *PPCW_MASK_INFORMATION;

Member

CounterMask

Eine Bitmaske. Wenn das x-te Bit festgelegt ist, wird der Zähler mit der ID x in der Abfrage enthalten.

InstanceMask

Eine Unicode-Zeichenfolge, die eine Wildcard-Spezifikation instance Namen enthält, die in der Abfrage abgeglichen werden sollen. Wenn alle instance Namen mit der Abfrage übereinstimmen sollen, lautet "*"das InstanceMask Feld . "*" Andernfalls haben und "?" die übliche Wildcard-Bedeutung von "null-oder-mehr-Zeichen" bzw. "any-character". Beachten Sie, dass bei instance Namensabgleich die Groß-/Kleinschreibung nicht beachtet wird.

InstanceId

Der numerische Wert, der die ID der zu sammelnden instance identifiziert. Wenn der Wert (0xFFFFFFFF) lautet PCW_ANY_INSTANCE_ID , sollten alle instance IDs mit der Abfrage übereinstimmen.

CollectMultiple

Der BOOLESCHE Wert, der angibt, ob der Consumer mehrere instance in den Ergebnissen der Abfrage akzeptiert. Dies ist FALSE, wenn die Zählermenge als single-instance Counterset behandelt wird. Dies ist TRUE, wenn die Zählermenge als Multi-instance-Counterset behandelt wird.

Dieser Wert kann verwendet werden, um die Datensammlung zu optimieren. Wenn CollectMultiple false ist, kann der Datensammlungsrückruf nach dem Hinzufügen eines instance zurückgegeben werden, da zusätzliche Instanzen vom Consumer ignoriert werden.

Buffer

Ein Handle für den vom System verwalteten Puffer, dem die instance der Zählermenge hinzugefügt werden. Dieses Handle sollte beim Aufrufen von PcwAddInstance oder beim Aufrufen der von CTRPP generierten AddXxx-Funktion verwendet werden, die den Aufruf von PcwAddInstance umschließt. Weitere Informationen finden Sie in den Hinweisen auf dieser Seite.

CancelEvent

Wenn dieses Feld nicht NULL ist, handelt es sich um ein initialisiertes Ereignisobjekt, das signalisiert wird, wenn die Anforderung abgebrochen wird.

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

_PCW_CALLBACK_INFORMATION-Struktur