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