estructura COUNTED_REASON_CONTEXT (wdm.h)
La estructura de COUNTED_REASON_CONTEXT contiene una o varias cadenas que proporcionan razones para una solicitud de alimentación.
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 terminada en null de caracteres anchos que contiene el nombre de ruta de acceso de un archivo de recursos. Este archivo de recursos contiene una o varias cadenas localizadas que proporcionan razones 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 Flags = 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 Flags = 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 Flags = 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 terminada en null de caracteres anchos. StringCount especifica el número de elementos de matriz. Este miembro solo es válido si Flags = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.SimpleString
Puntero a una cadena terminada en caracteres anchos y terminada en NULL que explica el motivo de una solicitud de alimentación. Este miembro solo es válido si Flags = DIAGNOSTIC_REASON_SIMPLE_STRING.
Comentarios
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 miembros ResourceFileName, ResourceReasonId, StringCount y 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 los recursos STRINGTABLE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con Windows 7 y versiones posteriores del sistema operativo Windows. |
| Encabezado | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h) |