struktur PCW_COUNTER_DESCRIPTOR (wdm.h)
Struktur PCW_COUNTER_DESCRIPTOR ini digunakan untuk memberikan informasi tentang nilai penghitung selama pendaftaran counterset. Sebagian besar pengembang tidak perlu mengakses struktur ini secara langsung karena secara otomatis dikelola oleh kode pendaftaran counterset yang dihasilkan oleh alat CTRPP .
Sintaks
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
Anggota
Id
Nilai numerik yang menentukan ID penghitung yang dijelaskan oleh struktur ini. Ini harus cocok dengan nilai yang disediakan di id bidang elemen penghitung dalam manifes counterset penyedia.
StructIndex
Nilai numerik yang menentukan indeks ke dalam array struktur PCW_DATA . Dalam panggilan berikutnya ke PcwCreateInstance atau PcwAddInstance, blok data yang dijelaskan oleh PcwData[PcwCounterDescriptor->StructIndex] akan digunakan sebagai sumber data untuk penghitung dengan ID PcwCounterDescriptor->Id.
Offset
Nilai numerik yang menentukan offset (dalam byte) relatif terhadap blok data yang ditunjukkan StructIndex oleh bidang . Dalam panggilan berikutnya ke PcwCreateInstance atau , alamat PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset akan digunakan sebagai awal nilai untuk penghitung dengan ID PcwCounterDescriptor->IdPcwAddInstance.
Size
Nilai numerik yang menentukan ukuran, dalam byte, dari nilai untuk penghitung dengan ID PcwCounterDescriptor->Id. Bidang Size harus diatur ke 4 (untuk UINT32 nilai penghitung) atau 8 (untuk nilai penghitung UINT64 ).
Keterangan
Sebagian besar pengembang tidak perlu menggunakan struktur ini secara langsung. Alat ini CTRPP menghasilkan kode pendaftaran yang menginisialisasi PCW_COUNTER_DESCRIPTOR struktur berdasarkan konten manifes penyedia.
Array PCW_COUNTER_DESCRIPTOR struktur disediakan selama pendaftaran counterset (melalui struktur PCW_REGISTRATION_INFORMATION diteruskan ke PcwRegister). Informasi dari array direkam dan akan digunakan oleh PcwCreateInstance atau PcwAddInstance untuk mengekstrak nilai penghitung dari blok data yang PCW_DATA dijelaskan oleh array.
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) |