SP_POWERMESSAGEWAKE_PARAMS_A structure (setupapi.h)

An SP_POWERMESSAGEWAKE_PARAMS structure corresponds to a DIF_POWERMESSAGEWAKE installation request.

Syntax

typedef struct _SP_POWERMESSAGEWAKE_PARAMS_A {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  CHAR                   *PowerMessageWake[LINE_LEN  2];
} SP_POWERMESSAGEWAKE_PARAMS_A, *PSP_POWERMESSAGEWAKE_PARAMS_A;

Members

ClassInstallHeader

An install request header that contains the header size and the DIF code for the request. See SP_CLASSINSTALL_HEADER.

PowerMessageWake[LINE_LEN * 2]

Buffer that contains a string of custom text. Windows displays this text on the power management page of the device properties display in Device Manager.

Remarks

Windows only sends the DIF_POWERMESSAGEWAKE request if the drivers for the device support power management.

Note

The setupapi.h header defines SP_POWERMESSAGEWAKE_PARAMS as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Header setupapi.h (include Setupapi.h)

See also

DIF_POWERMESSAGEWAKE

SP_CLASSINSTALL_HEADER