Condividi tramite


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

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, %2e 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)

Vedere anche

PoCreatePowerRequest