struktur PCW_COUNTER_DESCRIPTOR (wdm.h)

  • Artikel

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)

Lihat juga

struktur _PCW_REGISTRATION_INFORMATION

struktur _PCW_DATA

CTRPP

penghitung Jenis Kompleks