struktur PCW_MASK_INFORMATION (wdm.h)

Struktur PCW_MASK_INFORMATION adalah jenis anggota EnumerateInstances dan CollectData dari serikat _PCW_CALLBACK_INFORMATION . Ini berisi detail pemberitahuan yang dikirim oleh sistem ke fungsi PCW_CALLBACK yang ditentukan penyedia.

Sintaks

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;

Anggota

CounterMask

Sebuah bitmask. xJika bit -th diatur, penghitung dengan ID x disertakan dalam kueri.

InstanceMask

String Unicode yang berisi spesifikasi wildcard nama instans yang akan dicocokkan dalam kueri. Jika semua nama instans harus cocok dengan kueri, InstanceMask bidang akan menjadi "*". Jika tidak, "*" dan "?" memiliki arti kartubebas yang biasa dari "karakter nol atau lebih" dan "karakter apa pun". Perhatikan bahwa pencocokan nama instans tidak peka huruf besar/kecil.

InstanceId

Nilai numerik yang mengidentifikasi ID instans yang akan dikumpulkan. Jika nilainya ( PCW_ANY_INSTANCE_ID 0xFFFFFFFF), semua ID instans harus cocok dengan kueri.

CollectMultiple

Nilai BOOLEAN yang menunjukkan apakah konsumen akan menerima lebih dari satu instans dalam hasil kueri. Ini akan menjadi FALSE jika penghitung diperlakukan sebagai penghitung instans tunggal. Ini akan MENJADI TRUE jika penghitung diperlakukan sebagai penghitung multi-instans.

Nilai ini dapat digunakan untuk mengoptimalkan pengumpulan data. Jika CollectMultiple salah maka panggilan balik pengumpulan data dapat kembali setelah menambahkan satu instans karena instans tambahan akan diabaikan oleh konsumen.

Buffer

Handel ke buffer yang dikelola sistem tempat instans penghitung akan ditambahkan. Handel ini harus digunakan saat memanggil PcwAddInstance - atau saat memanggil fungsi AddXxx yang dihasilkan CTRPP, yang membungkus panggilan ke PcwAddInstance. Untuk informasi selengkapnya, lihat Keterangan halaman tersebut.

CancelEvent

Jika bidang ini non-NULL, ini adalah objek peristiwa yang diinisialisasi yang akan disinyalkan jika permintaan dibatalkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 7 dan versi Windows yang lebih baru.
Header	wdm.h (termasuk Wdm.h, Ntddk.h)

Lihat juga

PCW_CALLBACK fungsi panggilan balik

struktur _PCW_CALLBACK_INFORMATION