estructura COUNTED_REASON_CONTEXT (ntpoapi.h)
La estructura COUNTED_REASON_CONTEXT contiene una o varias cadenas que dan motivos para una solicitud de energía.
Sintaxis
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;
Miembros
Version
Número de versión de la estructura. Establezca este miembro en DIAGNOSTIC_REASON_VERSION.
Flags
Indica si la estructura contiene una cadena de motivo simple o un conjunto detallado de cadenas de motivo. Establezca este miembro en una de las siguientes constantes:
- DIAGNOSTIC_REASON_SIMPLE_STRING
- DIAGNOSTIC_REASON_DETAILED_STRING
DUMMYUNIONNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceFileName
Puntero a una cadena de caracteres anchos y terminada en NULL que contiene el nombre de ruta de acceso de un archivo de recursos. Este archivo de recursos contiene una o varias cadenas localizadas que dan motivos para una solicitud de energía. Este miembro es opcional y se puede especificar como NULL o como una cadena vacía si no se requiere ningún archivo de recursos. Este miembro solo es válido si Marcas = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceReasonId
Identificador de recurso asignado a la primera cadena de motivo del archivo de recursos especificado por ResourceFileName. Este miembro solo es válido si Marcas = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.StringCount
Número de cadenas de motivo en la matriz ReasonStrings o en el archivo de recursos especificado por ResourceFileName. Este miembro solo es válido si Marcas = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ReasonStrings
Puntero a una matriz de punteros de cadena. Cada elemento de matriz es un puntero a una cadena de caracteres anchos y terminada en NULL. El número de elementos de matriz se especifica mediante StringCount. Este miembro solo es válido si Marcas = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.SimpleString
Puntero a una cadena de caracteres anchos y terminada en NULL que explica el motivo de una solicitud de energía. Este miembro solo es válido si Marcas = DIAGNOSTIC_REASON_SIMPLE_STRING.
Observaciones
Esta estructura la usa la rutina PoCreatePowerRequest.
El administrador de energía usa la cadena de motivo o las cadenas contenidas en esta estructura como ayuda de diagnóstico durante las pruebas funcionales y de rendimiento.
La estructura COUNTED_REASON_CONTEXT puede contener una cadena de motivo simple o un conjunto de cadenas de motivo detalladas. Si Flags = DIAGNOSTIC_REASON_SIMPLE_STRING, el miembro SimpleString apunta a una cadena que explica el motivo de la solicitud de energía. Si Flags = DIAGNOSTIC_REASON_DETAILED_STRING, los ResourceFileName, ResourceReasonId, StringCounty los miembros ReasonStrings pueden proporcionar un conjunto detallado de motivos para la solicitud de energía.
La marca DIAGNOSTIC_REASON_DETAILED_STRING admite la localización. Si el archivo de recursos localizado especificado por ResourceFileName existe, el administrador de energía recupera la cadena de recurso especificada por ResourceReasonId del archivo y, a continuación, da formato a la cadena, reemplazando %1, %2, etc. marcadores de posición con los elementos correspondientes de la matriz ReasonStrings. No se admiten otros especificadores de formato usados con FormatMessageW.
El administrador de energía recupera las cadenas de recursos de recursos STRINGTABLE.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con Windows 7 y versiones posteriores del sistema operativo Windows. |
| encabezado de | ntpoapi.h (incluya Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h) |