winperf.h (PERF_INSTANCE_DEFINITION 結構)

描述性能對象的實例。

語法

typedef struct _PERF_INSTANCE_DEFINITION {
  DWORD ByteLength;
  DWORD ParentObjectTitleIndex;
  DWORD ParentObjectInstance;
  LONG  UniqueID;
  DWORD NameOffset;
  DWORD NameLength;
} PERF_INSTANCE_DEFINITION, *PPERF_INSTANCE_DEFINITION;

成員

ByteLength

這個結構的大小，包括後面以位元組為單位的實例名稱。 此值必須是8位元組的倍數。

ParentObjectTitleIndex

標題資料庫中父物件名稱的索引。 例如，如果對像是線程，父對像是進程，或者對像是邏輯磁碟驅動器，則父系是實體磁碟驅動器。

ParentObjectInstance

實例在與此實例相關聯的父物件內的位置。 位置是以零起始。

UniqueID

您可以用來識別實例的唯一標識碼，而不是使用名稱來識別實例。 如果您未使用唯一標識符來區分計數器實例，請將此成員設定為 PERF_NO_UNIQUE_ID。

NameOffset

從這個 結構的開頭位移至這個實例的 Unicode 名稱。

NameLength

實例名稱的長度，包括 null 終止符，以位元組為單位。 如果實例沒有名稱，則這個成員為零。

請勿包含在您新增至實例名稱的任何填補長度中，以確保 ByteLength 會對齊 8 位元組界限。

備註

如果 PERF_OBJECT_TYPE 的 NumInstances 成員大於零，則物件會包含 實例。 使用 PERF_OBJECT_TYPE 的DefinitionLength成員來尋找物件的第一個實例。 如需詳細資訊，請參閱 效能數據格式。

如果指定，取用者應該使用父實例名稱來建立用於顯示的完整實例名稱。 慣例是將名稱形成父子系。

提供者應該使用唯一的實例名稱。 如果您不這麼做，取用者很難計算和顯示效能值，因為它們無法分辨目前實例是否參考先前查詢的相同實例， (實例可以來回) 。

提供者必須為實例名稱配置足夠的空間，以確保 ByteLength 與 8 位元組界限對齊。

規格需求

另請參閱

PERF_OBJECT_TYPE