estrutura COUNTED_REASON_CONTEXT (ntpoapi.h)

A estrutura COUNTED_REASON_CONTEXT contém uma ou mais cadeias de caracteres que fornecem motivos para uma solicitação de energia.

Sintaxe

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;

Membros

Version

O número de versão da estrutura. Defina esse membro como DIAGNOSTIC_REASON_VERSION.

Flags

Indica se a estrutura contém uma cadeia de caracteres de motivo simples ou um conjunto detalhado de cadeias de caracteres de motivo. Defina esse membro como uma das seguintes constantes:

• DIAGNOSTIC_REASON_SIMPLE_STRING
• DIAGNOSTIC_REASON_DETAILED_STRING

Se Flags = DIAGNOSTIC_REASON_SIMPLE_STRING, o membro SimpleString da união será válido. Se Flags = DIAGNOSTIC_REASON_DETAILED_STRING, os membros ResourceFileName, ResourceReasonId, StringCount e ReasonStrings são válidos (e o membro SimpleString não é válido).

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceFileName

Um ponteiro para uma cadeia de caracteres largo e terminada em nulo que contém o nome do caminho de um arquivo de recurso. Esse arquivo de recurso contém uma ou mais cadeias de caracteres localizadas que fornecem motivos para uma solicitação de energia. Esse membro é opcional e pode ser especificado como NULL ou como uma cadeia de caracteres vazia se nenhum arquivo de recurso for necessário. Esse membro só será válido se Flags = DIAGNOSTIC_REASON_DETAILED_STRING.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceReasonId

A ID do recurso atribuída à primeira cadeia de caracteres de motivo no arquivo de recurso especificado por ResourceFileName. Esse membro só será válido se Flags = DIAGNOSTIC_REASON_DETAILED_STRING.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.StringCount

O número de cadeias de caracteres de motivo na matriz ReasonStrings ou no arquivo de recurso especificado por ResourceFileName. Esse membro só será válido se Flags = DIAGNOSTIC_REASON_DETAILED_STRING.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ReasonStrings

Um ponteiro para uma matriz de ponteiros de cadeia de caracteres. Cada elemento de matriz é um ponteiro para uma cadeia de caracteres largos e terminada em nulo. O número de elementos de matriz é especificado por StringCount. Esse membro só será válido se Flags = DIAGNOSTIC_REASON_DETAILED_STRING.

DUMMYUNIONNAME.SimpleString

Um ponteiro para uma cadeia de caracteres largo e terminada em nulo que explica o motivo de uma solicitação de energia. Esse membro só será válido se Flags = DIAGNOSTIC_REASON_SIMPLE_STRING.

Comentários

Essa estrutura é usada pela rotina PoCreatePowerRequest .

O power manager usa a cadeia de caracteres ou cadeias de caracteres de motivo contidas nessa estrutura como um auxílio de diagnóstico durante testes funcionais e de desempenho.

A estrutura COUNTED_REASON_CONTEXT pode conter uma cadeia de caracteres de motivo simples ou um conjunto de cadeias de caracteres de motivo detalhadas. Se Flags = DIAGNOSTIC_REASON_SIMPLE_STRING, o membro SimpleString apontará para uma cadeia de caracteres que explica o motivo da solicitação de energia. Se Flags = DIAGNOSTIC_REASON_DETAILED_STRING, os membros ResourceFileName, ResourceReasonId, StringCount e ReasonStrings poderão fornecer um conjunto detalhado de motivos para a solicitação de energia.

O sinalizador DIAGNOSTIC_REASON_DETAILED_STRING dá suporte à localização. Se o arquivo de recurso localizado especificado por ResourceFileName existir, o power manager recuperará a cadeia de caracteres de recurso especificada por ResourceReasonId do arquivo e formata a cadeia de caracteres, substituindo %1, %2etc. espaços reservados com itens correspondentes da matriz ReasonStrings . Não há suporte para outros especificadores de formato usados com FormatMessageW .

O power manager recupera as cadeias de caracteres de recursos de recursos STRINGTABLE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no Windows 7 e versões posteriores do sistema operacional Windows.
Cabeçalho	ntpoapi.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h)

Confira também

PoCreatePowerRequest