Função DriverCallback (mmiscapi.h)

  • Artigo

Chama uma função de retorno de chamada, envia uma mensagem para uma janela ou desbloqueia um thread. A ação depende do valor do sinalizador de notificação. Essa função destina-se a ser usada somente dentro da função DriverProc de um driver instalável.

Sintaxe

BOOL DriverCallback(
  DWORD_PTR dwCallback,
  DWORD     dwFlags,
  HDRVR     hDevice,
  DWORD     dwMsg,
  DWORD_PTR dwUser,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2
);

Parâmetros

dwCallback

Endereço da função de retorno de chamada, um identificador de janela ou um identificador de tarefa, dependendo do sinalizador especificado no parâmetro dwFlags .

dwFlags

Sinalizadores de notificação. Pode ser um dos valores a seguir:

Valor Significado
DCB_NOSWITCH
 O sistema é impedido de alternar pilhas. Esse valor só será usado se houver espaço de pilha suficiente para a função de retorno de chamada.
DCB_FUNCTION
 O parâmetro dwCallback é o endereço de uma função de retorno de chamada definida pelo aplicativo. O sistema envia a mensagem de retorno de chamada para a função de retorno de chamada.
DCB_WINDOW
 O parâmetro dwCallback é o identificador de uma janela definida pelo aplicativo. O sistema envia notificações subsequentes para a janela.
DCB_TASK
 O parâmetro dwCallback é o identificador de um aplicativo ou tarefa. O sistema envia notificações subsequentes para o aplicativo ou tarefa.

hDevice

Identificador da instância do driver instalável.

dwMsg

Valor da mensagem.

dwUser

Dados de instância de usuário de 32 bits fornecidos pelo aplicativo quando o dispositivo foi aberto.

dwParam1

Parâmetro dependente de mensagem de 32 bits.

dwParam2

Parâmetro dependente de mensagem de 32 bits.

Retornar valor

Retornará TRUE se tiver êxito ou FALSO se um parâmetro for inválido ou a fila de mensagens da tarefa estiver cheia.

Comentários

O cliente especifica como notificá-lo quando o dispositivo é aberto. Os sinalizadores DCB_FUNCTION e DCB_WINDOW são equivalentes à palavra de alta ordem dos sinalizadores correspondentes CALLBACK_FUNCTION e CALLBACK_WINDOW especificados no parâmetro lParam2 da mensagem DRV_OPEN quando o dispositivo foi aberto.

Se a notificação for realizada com uma função de retorno de chamada, hdrvr, msg, dwUser, dwParam1 e dwParam2 serão passados para a função de retorno de chamada. Se a notificação for realizada por meio de uma janela, somente msg, hdrvr e dwParam1 serão passados para a janela.

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]
Plataforma de Destino Windows
Cabeçalho mmiscapi.h (inclua Mmiscapi.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Funções do driver

Drivers instaláveis