struttura REASON_CONTEXT (minwinbase.h)

Contiene informazioni su una richiesta di alimentazione. Questa struttura viene usata dalle funzioni PowerCreateRequest e SetWaitableTimerEx .

Sintassi

typedef struct _REASON_CONTEXT {
  ULONG Version;
  DWORD Flags;
  union {
    struct {
      HMODULE LocalizedReasonModule;
      ULONG   LocalizedReasonId;
      ULONG   ReasonStringCount;
      LPWSTR  *ReasonStrings;
    } Detailed;
    LPWSTR SimpleReasonString;
  } Reason;
} REASON_CONTEXT, *PREASON_CONTEXT;

Members

Version

Numero di versione della struttura. Questo parametro deve essere impostato su POWER_REQUEST_CONTEXT_VERSION.

Flags

Formato del motivo della richiesta di alimentazione. Questo parametro può essere uno dei valori seguenti:

Reason

Unione costituita da una struttura Dettagliata o da una stringa.

Reason.Detailed

Struttura che identifica una risorsa stringa localizzabile per descrivere il motivo della richiesta di alimentazione.

Reason.Detailed.LocalizedReasonModule

Modulo che contiene la risorsa stringa.

Reason.Detailed.LocalizedReasonId

ID della risorsa stringa.

Reason.Detailed.ReasonStringCount

Numero di stringhe nel parametro ReasonStrings .

Reason.Detailed.ReasonStrings

Matrice di stringhe da sostituire nella risorsa stringa in fase di esecuzione.

Reason.SimpleReasonString

Stringa non localizzata che descrive il motivo della richiesta di alimentazione.

Commenti

È possibile passare stringhe di sola lettura come SimpleReasonString o ReasonStrings perché le funzioni PowerCreateRequest e SetWaitableTimerEx leggono dalle stringhe e non le scrivono.

Requisiti

Vedi anche

PowerCreateRequest

SetWaitableTimerEx