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) |