通过

COUNTED_REASON_CONTEXT结构 （ntpoapi.h）

  • 项目

COUNTED_REASON_CONTEXT 结构包含一个或多个字符串，这些字符串提供电源请求的原因。

语法

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;

成员

Version

结构的版本号。 将此成员设置为DIAGNOSTIC_REASON_VERSION。

Flags

指示结构是包含一个简单的原因字符串还是一组详细的原因字符串。 将此成员设置为下列常量之一：

  • DIAGNOSTIC_REASON_SIMPLE_STRING
  • DIAGNOSTIC_REASON_DETAILED_STRING
如果 标志 = DIAGNOSTIC_REASON_SIMPLE_STRING，则联合 SimpleString 成员有效。 如果 标志 = DIAGNOSTIC_REASON_DETAILED_STRING，则 ResourceFileName、ResourceReasonId、StringCount，ReasonStrings 成员有效（以及 simpleString 成员 无效）。

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceFileName

指向包含资源文件路径名称的宽字符、以 null 结尾的字符串的指针。 此资源文件包含一个或多个本地化字符串，这些字符串提供电源请求的原因。 此成员是可选的，可以指定为 NULL 或空字符串（如果不需要资源文件）。 仅当 标志 = DIAGNOSTIC_REASON_DETAILED_STRING时，此成员才有效。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceReasonId

分配给资源文件中由 ResourceFileName指定的第一个原因字符串的资源 ID。 仅当 标志 = DIAGNOSTIC_REASON_DETAILED_STRING时，此成员才有效。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.StringCount

ReasonStrings 数组或由 resourceFileName指定的资源文件中的原因字符串数。 仅当 标志 = DIAGNOSTIC_REASON_DETAILED_STRING时，此成员才有效。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ReasonStrings

指向字符串指针数组的指针。 每个数组元素都是指向宽字符、以 null 结尾的字符串的指针。 数组元素的数目由 StringCount指定。 仅当 标志 = DIAGNOSTIC_REASON_DETAILED_STRING时，此成员才有效。

DUMMYUNIONNAME.SimpleString

指向宽字符、以 null 结尾的字符串的指针，该字符串解释了电源请求的原因。 仅当 标志 = DIAGNOSTIC_REASON_SIMPLE_STRING时，此成员才有效。

言论

PoCreatePowerRequest 例程使用此结构。

power Manager 使用此结构中包含的原因字符串或字符串作为功能和性能测试期间的诊断帮助。

COUNTED_REASON_CONTEXT 结构可以包含简单的原因字符串或一组详细的原因字符串。 如果 标志 = DIAGNOSTIC_REASON_SIMPLE_STRING，则 SimpleString 成员指向解释电源请求原因的字符串。 如果 标志 = DIAGNOSTIC_REASON_DETAILED_STRING，则 ResourceFileName、ResourceReasonId、StringCount，ReasonStrings 成员可以提供一组详细的电源请求原因。

DIAGNOSTIC_REASON_DETAILED_STRING标志支持本地化。 如果存在由 ResourceFileName 指定的本地化资源文件，则 Power Manager 将从文件中检索由 ResourceReasonId 指定的资源字符串，然后设置字符串的格式，替换 %1、%2等。 包含来自 ReasonStrings 数组中的相应项的占位符。 不支持用于 FormatMessageW 的其他格式说明符。

Power Manager 从 STRINGTABLE 资源检索资源字符串。

要求

要求 价值
最低支持的客户端 在 Windows 7 及更高版本的 Windows作系统中受支持。
标头 ntpoapi.h （包括 Wdm.h、Ntddk.h、Ntifs.h、Ntpoapi.h）

另请参阅

PoCreatePowerRequest