Compartilhar via

Função de retorno de chamada DRIVERPROC (mmiscapi.h)

  • Artigo

Processa mensagens de driver para o driver instalável. DriverProc é uma função fornecida pelo driver.

Sintaxe

DRIVERPROC Driverproc;

LRESULT Driverproc(
  DWORD_PTR unnamedParam1,
  HDRVR unnamedParam2,
  UINT unnamedParam3,
  LPARAM unnamedParam4,
  LPARAM unnamedParam5
)
{...}

Parâmetros

unnamedParam1

Identificador do driver instalável.

unnamedParam2

Identificador da instância do driver instalável. Cada instância do driver instalável tem um identificador exclusivo.

unnamedParam3

Valor da mensagem do driver. Pode ser um valor personalizado ou um destes valores padrão:

Valor Significado
DRV_CLOSE
 Notifica o driver de que ele deve diminuir sua contagem de uso e descarregar o driver se a contagem for zero.
DRV_CONFIGURE
 Notifica o driver de que ele deve exibir uma caixa de diálogo de configuração. Essa mensagem será enviada somente se o driver retornar um valor diferente de zero ao processar a mensagem DRV_QUERYCONFIGURE .
DRV_DISABLE
 Notifica o driver de que sua memória alocada está prestes a ser liberada.
DRV_ENABLE
 Notifica o driver de que ele foi carregado ou recarregado ou que o Windows foi habilitado.
DRV_FREE
 Notifica o driver de que ele será descartado.
DRV_INSTALL
 Notifica o driver de que ele foi instalado com êxito.
DRV_LOAD
 Notifica o driver de que ele foi carregado com êxito.
DRV_OPEN
 Notifica o driver de que ele está prestes a ser aberto.
DRV_POWER
 Notifica o driver de que a fonte de alimentação do dispositivo está prestes a ser ativada ou desativada.
DRV_QUERYCONFIGURE
 Direciona o driver para especificar se ele dá suporte à mensagem DRV_CONFIGURE .
DRV_REMOVE
 Notifica o driver de que ele está prestes a ser removido do sistema.

unnamedParam4

Valor específico da mensagem de 32 bits.

unnamedParam5

Valor específico da mensagem de 32 bits.

Valor retornado

Retornará diferente de zero se tiver êxito ou zero caso contrário.

Comentários

Quando msg é DRV_OPEN, lParam1 é a cadeia de caracteres seguindo o nome do arquivo de driver do arquivo SYSTEM.INI e lParam2 é o valor fornecido como o parâmetro lParam em uma chamada para a função OpenDriver .

Quando msg é DRV_CLOSE, lParam1 e lParam2 são os mesmos valores que os parâmetros lParam1 e lParam2 em uma chamada para a função CloseDriver .

Requisitos

   
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]
Plataforma de Destino Windows
Cabeçalho mmiscapi.h (inclua Mmiscapi.h, Windows.h)

Confira também

Funções do driver

Drivers instaláveis