estructura PCW_MASK_INFORMATION (wdm.h)
La PCW_MASK_INFORMATION estructura es el tipo de los EnumerateInstances miembros y CollectData de la unión _PCW_CALLBACK_INFORMATION . Contiene detalles de una notificación enviada por el sistema a una función de PCW_CALLBACK definida por el proveedor.
Sintaxis
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;
Miembros
CounterMask
Máscara de bits. Si se establece el xbit -th, el contador con id. x se incluye en la consulta.
InstanceMask
Cadena Unicode que contiene una especificación de caracteres comodín de los nombres de instancia que se van a buscar coincidencias en la consulta. Si todos los nombres de instancia deben coincidir con la consulta, el InstanceMask campo será "*". De lo contrario, "*" y "?" tienen el significado comodín habitual de "cero o más caracteres" y "cualquier carácter", respectivamente. Tenga en cuenta que la coincidencia de nombres de instancia no distingue mayúsculas de minúsculas.
InstanceId
Valor numérico que identifica el identificador de las instancias que se van a recopilar. Si el valor es PCW_ANY_INSTANCE_ID (0xFFFFFFFF), todos los identificadores de instancia deben coincidir con la consulta.
CollectMultiple
Valor BOOLEAN que indica si el consumidor aceptará más de una instancia en los resultados de la consulta. Esto será FALSE si el conjunto de contadores se trata como un conjunto de contadores de instancia única. Esto será TRUE si el conjunto de contadores se trata como un conjunto de contadores de varias instancias.
Este valor se puede usar para optimizar la recopilación de datos. Si CollectMultiple es false, la devolución de llamada de recopilación de datos puede devolver después de agregar una instancia, ya que el consumidor omitirá las instancias adicionales.
Buffer
Identificador del búfer administrado por el sistema al que se agregarán las instancias del conjunto de contadores. Este identificador se debe usar al llamar a PcwAddInstance o al llamar a la función AddXxx generada por CTRPP, que ajusta la llamada a PcwAddInstance. Para obtener más información, consulta los comentarios de esa página.
CancelEvent
Si este campo no es NULL, es un objeto de evento inicializado que se indicará si se cancela la solicitud.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 7 y versiones posteriores de Windows. |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h) |