DIF_POWERMESSAGEWAKE

Uma solicitação de DIF_POWERMESSAGEWAKE permite que um instalador forneça texto personalizado que o Windows exibe na página de propriedades de gerenciamento de energia das propriedades do dispositivo.

Quando enviado

Quando um usuário clica em um item de menu ou guia para exibir as propriedades de um dispositivo.

O Windows só enviará essa solicitação DIF se os drivers do dispositivo deem suporte ao gerenciamento de energia. Caso contrário, o Windows não exibirá nenhuma propriedade de energia para o dispositivo.

Quem manipula

Co-instalador de classe

Pode manipular

Co-instalador de dispositivo

Pode manipular

Instalador de Classe

Pode manipular

Entrada do instalador

DeviceInfoSet
Fornece um identificador para o conjunto de informações do dispositivo que contém o dispositivo.

DeviceInfoData
Fornece um ponteiro para uma estrutura SP_DEVINFO_DATA que identifica o dispositivo no conjunto de informações do dispositivo.

Parâmetros de instalação do dispositivo
Há parâmetros de instalação do dispositivo (SP_DEVINSTALL_PARAMS) associados ao DeviceInfoData.

Parâmetros de instalação de classe
Uma estrutura SP_POWERMESSAGEWAKE_PARAMS está associada ao DeviceInfoData.

Saída do instalador

Parâmetros de instalação de classe
Um instalador pode modificar o SP_POWERMESSAGEWAKE_PARAMS para fornecer texto personalizado para a página de propriedades de energia de um dispositivo.

Valor retornado do instalador

Um co-instalador normalmente retorna NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED ou um código de erro Win32.

Um instalador de classe retornará NO_ERROR se fornecer com êxito o texto das propriedades de energia. Caso contrário, um instalador de classe retornará ERROR_DI_DO_DEFAULT ou um código de erro Win32.

Manipulador de código DIF padrão

Nenhum

Operação do instalador

Uma solicitação DIF_POWERMESSAGEWAKE permite que um instalador forneça o texto que o Windows exibe na página de propriedades de energia de um dispositivo.

Se um co-instalador fornecer texto de propriedades de energia, ele deverá fazê-lo em sua fase de pós-processamento. Um co-instalador deve ter cuidado ao substituir qualquer texto de propriedades de energia fornecido por um instalador que lidou com a solicitação antes do co-instalador.

Para obter mais informações sobre códigos DIF, consulte Manipulando códigos DIF.

Requisitos

Versão

Com suporte no Microsoft Windows 2000 e versões posteriores do Windows.

Cabeçalho

Setupapi.h (inclua Setupapi.h)

Confira também

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_POWERMESSAGEWAKE_PARAMS