COUNTED_REASON_CONTEXT Struktur (ntpoapi.h)
Die COUNTED_REASON_CONTEXT-Struktur enthält eine oder mehrere Zeichenfolgen, die Gründe für eine Energieanforderung geben.
Syntax
typedef struct _COUNTED_REASON_CONTEXT {
ULONG Version;
ULONG Flags;
union {
struct {
UNICODE_STRING ResourceFileName;
USHORT ResourceReasonId;
ULONG StringCount;
PUNICODE_STRING ReasonStrings;
} DUMMYSTRUCTNAME;
UNICODE_STRING SimpleString;
} DUMMYUNIONNAME;
} COUNTED_REASON_CONTEXT, *PCOUNTED_REASON_CONTEXT;
Angehörige
Version
Die Versionsnummer der Struktur. Legen Sie dieses Element auf DIAGNOSTIC_REASON_VERSION fest.
Flags
Gibt an, ob die Struktur eine einfache Grundzeichenfolge oder einen detaillierten Satz von Grundzeichenfolgen enthält. Legen Sie dieses Element auf eine der folgenden Konstanten fest:
- DIAGNOSTIC_REASON_SIMPLE_STRING
- DIAGNOSTIC_REASON_DETAILED_STRING
DUMMYUNIONNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceFileName
Ein Zeiger auf eine Zeichenfolge mit breitem Zeichen, null-terminierte Zeichenfolge, die den Pfadnamen einer Ressourcendatei enthält. Diese Ressourcendatei enthält eine oder mehrere lokalisierte Zeichenfolgen, die Gründe für eine Energieanforderung geben. Dieses Element ist optional und kann als NULL- oder als leere Zeichenfolge angegeben werden, wenn keine Ressourcendatei erforderlich ist. Dieses Element ist nur gültig, wenn Flags = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceReasonId
Die Ressourcen-ID, die der ersten Grundzeichenfolge in der Ressourcendatei zugewiesen ist, die durch ResourceFileNameangegeben wird. Dieses Element ist nur gültig, wenn Flags = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.StringCount
Die Anzahl der Ursachenzeichenfolgen im ReasonStrings Array oder in der Ressourcendatei, die durch ResourceFileNameangegeben wird. Dieses Element ist nur gültig, wenn Flags = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ReasonStrings
Ein Zeiger auf ein Array von Zeichenfolgenzeigern. Jedes Arrayelement ist ein Zeiger auf eine Zeichenfolge mit breitem Zeichen, null-beendet. Die Anzahl der Arrayelemente wird durch StringCount-angegeben. Dieses Element ist nur gültig, wenn Flags = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.SimpleString
Ein Zeiger auf eine Zeichenfolge mit breitem Zeichen mit Null-Beendigung, die den Grund für eine Energieanforderung erläutert. Dieses Element ist nur gültig, wenn Flags = DIAGNOSTIC_REASON_SIMPLE_STRING.
Bemerkungen
Diese Struktur wird von der PoCreatePowerRequest Routine verwendet.
Der Power Manager verwendet die in dieser Struktur enthaltenen Gründe für Zeichenfolgen oder Zeichenfolgen als Diagnosehilfe bei Funktions- und Leistungstests.
Die COUNTED_REASON_CONTEXT-Struktur kann entweder eine einfache Grundzeichenfolge oder eine Reihe detaillierter Grundzeichenfolgen enthalten. Wenn Flags = DIAGNOSTIC_REASON_SIMPLE_STRING, zeigt das SimpleString-Element auf eine Zeichenfolge, die den Grund für die Energieanforderung erläutert. Wenn Flags = DIAGNOSTIC_REASON_DETAILED_STRING, können die ResourceFileName, ResourceReasonId, StringCountund ReasonStrings Member einen detaillierten Satz von Gründen für die Energieanforderung geben.
Das DIAGNOSTIC_REASON_DETAILED_STRING Flag unterstützt die Lokalisierung. Wenn die lokalisierte Ressourcendatei, die durch ResourceFileName- angegeben ist, vorhanden ist, ruft der Power Manager die durch ResourceReasonId angegebene Ressourcenzeichenfolge aus der Datei ab und formatiert dann die Zeichenfolge, ersetzt %1, %2usw. Platzhalter mit entsprechenden Elementen aus dem ReasonStrings Array. Andere Formatbezeichner, die mit FormatMessageW- verwendet werden, werden nicht unterstützt.
Der Power Manager ruft die Ressourcenzeichenfolgen aus STRINGTABLE-Ressourcenab.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in Windows 7 und höheren Versionen des Windows-Betriebssystems. |
| Header- | ntpoapi.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h) |