COUNTED_REASON_CONTEXT struttura (wdm.h)
La struttura COUNTED_REASON_CONTEXT contiene una o più stringhe che forniscono motivi per una richiesta di alimentazione.
Sintassi
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;
Members
Version
Numero di versione della struttura. Impostare questo membro su DIAGNOSTIC_REASON_VERSION.
Flags
Indica se la struttura contiene una stringa motivo semplice o un set dettagliato di stringhe motivo. Impostare questo membro su una delle costanti seguenti:
- DIAGNOSTIC_REASON_SIMPLE_STRING
- DIAGNOSTIC_REASON_DETAILED_STRING
DUMMYUNIONNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceFileName
Puntatore a una stringa con terminazione null wide che contiene il nome percorso di un file di risorse. Questo file di risorse contiene una o più stringhe localizzate che forniscono motivi per una richiesta di alimentazione. Questo membro è facoltativo e può essere specificato come NULL o come stringa vuota se non è necessario alcun file di risorse. Questo membro è valido solo se Flags = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceReasonId
ID risorsa assegnato alla prima stringa motivo nel file di risorse specificato da ResourceFileName. Questo membro è valido solo se Flags = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.StringCount
Numero di stringhe motivo nella matrice ReasonStrings o nel file di risorse specificato da ResourceFileName. Questo membro è valido solo se Flags = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ReasonStrings
Puntatore a una matrice di puntatori di stringa. Ogni elemento di matrice è un puntatore a una stringa con terminazione null a caratteri wide. Il numero di elementi della matrice viene specificato da StringCount. Questo membro è valido solo se Flags = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.SimpleString
Puntatore a una stringa con terminazione null a caratteri wide che spiega il motivo di una richiesta di alimentazione. Questo membro è valido solo se Flags = DIAGNOSTIC_REASON_SIMPLE_STRING.
Commenti
Questa struttura viene usata dalla routine PoCreatePowerRequest .
Il risparmio energia usa la stringa di motivo o le stringhe contenute in questa struttura come supporto diagnostico durante i test funzionali e delle prestazioni.
La struttura COUNTED_REASON_CONTEXT può contenere una semplice stringa motivo o un set di stringhe motivo dettagliate. Se Flags = DIAGNOSTIC_REASON_SIMPLE_STRING, il membro SimpleString punta a una stringa che spiega il motivo della richiesta di alimentazione. Se Flags = DIAGNOSTIC_REASON_DETAILED_STRING, i membri ResourceFileName, ResourceReasonId, StringCount e ReasonStrings possono fornire un set dettagliato di motivi per la richiesta di alimentazione.
Il flag DIAGNOSTIC_REASON_DETAILED_STRING supporta la localizzazione. Se il file di risorse localizzato specificato da ResourceFileName esiste, power manager recupera la stringa di risorsa specificata da ResourceReasonId dal file e quindi formatta la stringa, sostituendo %1, %2e così via. segnaposto con elementi corrispondenti dalla matrice ReasonStrings . Altri identificatori di formato usati con FormatMessageW non sono supportati.
Power Manager recupera le stringhe di risorse dalle risorse STRINGTABLE.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in Windows 7 e versioni successive del sistema operativo Windows. |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h) |