Função mmioInstallIOProcA (mmiscapi.h)

Artigo
11/20/2024

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 letras 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 indicando 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 de 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.

Valor de retorno

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

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	mmiscapi.h (inclua Mmiscapi.h, Windows.h)
biblioteca	Winmm.lib
de DLL	Winmm.dll

Compartilhar via