PCW_MASK_INFORMATION Struktur (wdm.h)
Die PCW_MASK_INFORMATION Struktur ist der Typ der EnumerateInstances und CollectData Mitglieder der _PCW_CALLBACK_INFORMATION Union. Sie enthält Details 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;
Angehörige
CounterMask
Eine Bitmaske. Wenn das x-th-Bit festgelegt ist, wird der Zähler mit der ID x in die Abfrage einbezogen.
InstanceMask
Eine Unicode-Zeichenfolge, die eine Wildcardspezifikation von Instanznamen enthält, die in der Abfrage abgeglichen werden sollen. Wenn alle Instanznamen der Abfrage entsprechen sollen, wird das feld InstanceMask"*". Andernfalls haben "*" und "?" die übliche Wildcard-Bedeutung von "Null-oder-mehr-Zeichen" bzw. "any-character". Beachten Sie, dass bei der Zuordnung von Instanzennamen keine Groß-/Kleinschreibung beachtet wird.
InstanceId
Der numerische Wert, der die ID der zu erfassenden Instanzen identifiziert. Wenn der Wert PCW_ANY_INSTANCE_ID (0xFFFFFFFF) ist, sollten alle Instanz-IDs mit der Abfrage übereinstimmen.
CollectMultiple
Der BOOLESCHE Wert, der angibt, ob der Consumer mehrere Instanzen in den Ergebnissen der Abfrage akzeptiert. Dies ist FALSE, wenn die Gegenmenge als Einzelinstanzzähler behandelt wird. Dies ist TRUE, wenn die Gegenmenge als Multiinstanzenzähler behandelt wird.
Dieser Wert kann verwendet werden, um die Datensammlung zu optimieren. Wenn CollectMultiple falsch ist, kann der Rückruf der Datensammlung nach dem Hinzufügen einer Instanz zurückgegeben werden, da zusätzliche Instanzen vom Consumer ignoriert werden.
Buffer
Ein Handle für den vom System verwalteten Puffer, dem die Instanzen des Zählers hinzugefügt werden. Dieses Handle sollte beim Aufrufen PcwAddInstance - oder beim Aufrufen der vom CTRPP generierten AddXxx-Funktion verwendet werden, die den Aufruf von PcwAddInstanceumschließt. Weitere Informationen finden Sie in den Anmerkungen zu 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Header- | wdm.h (include Wdm.h, Ntddk.h) |