Condividi tramite


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
Se Flags = DIAGNOSTIC_REASON_SIMPLE_STRING, il membro SimpleString dell'unione è valido. Se flag = DIAGNOSTIC_REASON_DETAILED_STRING, i membri ResourceFileName, ResourceReasonId, StringCount e ReasonStrings sono validi e il membro SimpleString non è valido.

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)

Vedi anche

PoCreatePowerRequest