Compartilhar via


DRV_CONFIGURE mensagem

Direciona o driver instalável para exibir sua caixa de diálogo de configuração e permitir que o usuário especifique novas configurações para a instância de driver instalável fornecida.

Parâmetros

dwDriverId

Identificador do driver instalável. Esse é o mesmo valor retornado anteriormente pelo driver da mensagem DRV_OPEN .

hdrvr

Identificador da instância do driver instalável.

Lparam1

Identificador da janela pai. Essa janela é usada como a janela pai da caixa de diálogo de configuração.

lParam2

Endereço de uma estrutura DRVCONFIGINFO ou NULL. Se a estrutura for fornecida, ela conterá os nomes da chave do Registro e o valor associados ao driver.

Valor Retornado

Retorna um destes valores:

Requisito Valor
DRVCNF_OK A configuração foi bem-sucedida; nenhuma ação adicional é necessária.
DRVCNF_CANCEL O usuário cancelou a caixa de diálogo; nenhuma ação adicional é necessária.
DRVCNF_RESTART A configuração foi bem-sucedida, mas as alterações não entrarão em vigor até que o sistema seja reiniciado.

Comentários

Alguns drivers instaláveis acrescentam informações de configuração ao valor atribuído ao valor do Registro associado ao driver.

Os valores retornados DRV_CANCEL, DRV_OK e DRV_RESTART estão obsoletos; eles foram substituídos por DRVCNF_CANCEL, DRVCNF_OK e DRVCNF_RESTART, respectivamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Mmsystem.h (incluir Windows.h)

Confira também

Drivers instaláveis

Mensagens de driver instaláveis