COUNTED_REASON_CONTEXT-Struktur (wdm.h)

Die COUNTED_REASON_CONTEXT-Struktur enthält mindestens eine Zeichenfolge, die Gründe für eine Energieanforderung angibt.

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;

Member

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 diesen Member auf eine der folgenden Konstanten fest:

• DIAGNOSTIC_REASON_SIMPLE_STRING
• DIAGNOSTIC_REASON_DETAILED_STRING

Wenn Flags = DIAGNOSTIC_REASON_SIMPLE_STRING, ist das SimpleString-Element der Union gültig. Wenn Flags = DIAGNOSTIC_REASON_DETAILED_STRING, sind die Member ResourceFileName, ResourceReasonId, StringCount und ReasonStrings gültig (und der SimpleString-Member ist ungültig).

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceFileName

Ein Zeiger auf eine Zeichenfolge mit Breitzeichen mit NULL-Beendigung, die den Pfadnamen einer Ressourcendatei enthält. Diese Ressourcendatei enthält mindestens eine lokalisierte Zeichenfolge, die Gründe für eine Energieanforderung angibt. Dieser Member ist optional und kann als NULL oder als leere Zeichenfolge angegeben werden, wenn keine Ressourcendatei erforderlich ist. Dieser Member 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 von ResourceFileName angegeben wird. Dieser Member ist nur gültig, wenn Flags = DIAGNOSTIC_REASON_DETAILED_STRING.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.StringCount

Die Anzahl der Grundzeichenfolgen im ReasonStrings-Array oder in der Ressourcendatei, die durch ResourceFileName angegeben wird. Dieser Member 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 Breitzeichenzeichenfolge mit NULL-Beendigung. Die Anzahl der Arrayelemente wird durch StringCount angegeben. Dieser Member 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 erklärt. Dieser Member ist nur gültig, wenn Flags = DIAGNOSTIC_REASON_SIMPLE_STRING.

Hinweise

Diese Struktur wird von der PoCreatePowerRequest-Routine verwendet.

Der Power Manager verwendet die in dieser Struktur enthaltenen Grundzeichenfolgen als Diagnosehilfe bei Funktions- und Leistungstests.

Die COUNTED_REASON_CONTEXT-Struktur kann entweder eine einfache Grundzeichenfolge oder einen Satz 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 Member ResourceFileName, ResourceReasonId, StringCount und ReasonStrings einen detaillierten Satz von Gründen für die Energieanforderung angeben.

Das flag DIAGNOSTIC_REASON_DETAILED_STRING unterstützt die Lokalisierung. Wenn die durch ResourceFileName angegebene lokalisierte Ressourcendatei vorhanden ist, ruft der Power Manager die von ResourceReasonId angegebene Ressourcenzeichenfolge aus der Datei ab und formatiert dann die Zeichenfolge, wobei %1, %2usw. ersetzt wird. 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-Ressourcen ab.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in Windows 7 und höheren Versionen des Windows-Betriebssystems.
Kopfzeile	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h)

Weitere Informationen

PoCreatePowerRequest