Compartilhar via

Função mmioInstallIOProcA (mmiscapi.h)

  • Artigo

A função mmioInstallIOProc instala ou remove um procedimento de E/S personalizado. Essa função também localiza um procedimento de E/S instalado, usando seu código de quatro caracteres correspondente.

Sintaxe

LPMMIOPROC mmioInstallIOProcA(
  FOURCC     fccIOProc,
  LPMMIOPROC pIOProc,
  DWORD      dwFlags
);

Parâmetros

fccIOProc

Código de quatro caracteres que identifica o procedimento de E/S para instalar, remover ou localizar. Todos os caracteres nesse código devem estar em maiúsculas.

pIOProc

Ponteiro para o procedimento de E/S a ser instalado. Para remover ou localizar um procedimento de E/S, defina esse parâmetro como NULL. Para obter mais informações sobre o procedimento de E/S, consulte MMIOProc.

dwFlags

Sinalizador que indica se o procedimento de E/S está sendo instalado, removido ou localizado. Os valores a seguir são definidos.

Valor Significado
MMIO_FINDPROC Pesquisa o procedimento de E/S especificado.
MMIO_GLOBALPROC Esse sinalizador é um modificador para o sinalizador MMIO_INSTALLPROC e indica que o procedimento de E/S deve ser instalado para uso global. Esse sinalizador será ignorado se MMIO_FINDPROC ou MMIO_REMOVEPROC for especificado.
MMIO_INSTALLPROC Instala o procedimento de E/S especificado.
MMIO_REMOVEPROC Remove o procedimento de E/S especificado.

Retornar valor

Retorna o endereço do procedimento de E/S instalado, removido ou localizado. Retornará NULL se houver um erro.

Comentários

Observação

O cabeçalho mmiscapi.h define mmioInstallIOProc como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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, Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll