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) |