struttura COUNTED_REASON_CONTEXT (ntpoapi.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;
Membri
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 a caratteri wide che contiene il 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 Flag = 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 Flag = 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 Flag = DIAGNOSTIC_REASON_DETAILED_STRING.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ReasonStrings
Puntatore a una matrice di puntatori di stringa. Ogni elemento della 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 Flag = 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 Flag = DIAGNOSTIC_REASON_SIMPLE_STRING.
Osservazioni
Questa struttura viene utilizzata 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 stringa motivo semplice o un set di stringhe motivo dettagliate. Se Flag = DIAGNOSTIC_REASON_SIMPLE_STRING, il membro SimpleString punta a una stringa che spiega il motivo della richiesta di alimentazione. Se Flag = DIAGNOSTIC_REASON_DETAILED_STRING, i membri ResourceFileName, ResourceReasonId, StringCounte 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
, %2
e così via. segnaposto con elementi corrispondenti dalla matrice reasonStrings. Altri identificatori di formato usati con FormatMessageW non sono supportati.
Il risparmio energia recupera le stringhe di risorse dalle risorse STRINGTABLE.
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Supportato in Windows 7 e versioni successive del sistema operativo Windows. |
intestazione | ntpoapi.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h) |