estrutura COUNTED_REASON_CONTEXT (wdm.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
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 | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h) |