Compartilhar via


comando signal

O comando signal identifica uma posição especificada no workspace enviando ao aplicativo uma mensagem de MM_MCISIGNAL . Os dispositivos de vídeo digital reconhecem esse comando. O MCIAVI dá suporte a apenas um sinal ativo por vez.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

_stprintf_s(
  lpszCommand, 
  TEXT("signal %s %s %s"), 
  lpszDeviceID, 
  lpszSignalFlags, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszSignalFlags

Um dos sinalizadores a seguir.

Valor Significado
na posição Especifica o quadro para invocar um sinal.
cancel Remove sinais do workspace. Um sinal individual é especificado usando o sinalizador "uservalue". Se o sinalizador "uservalue" não for especificado usando "cancelar", o dispositivo cancelará todos os sinais. O sinalizador "cancelar" é incompatível com os sinalizadores "at", "every" e "return position".
a cada intervalo Especifica o período dos sinais. O valor do intervalo é especificado no formato de hora atual. Se usados com a posição "at", os sinais são colocados em todo o workspace com uma marca de sinal colocada na posição.
Sem o sinalizador "at", os sinais são colocados em todo o workspace com um sinal na posição atual.
Se esse sinalizador for omitido, somente a posição indicada pelo sinalizador "at" será marcada.
Se o valor do intervalo for menor que a frequência mínima com suporte de um dispositivo, ele usará seu valor mínimo.
posição de retorno Indica que o dispositivo deve enviar o valor de posição em vez do identificador "uservalue" na mensagem de sinalização. O identificador "uservalue" ainda pode ser usado para cancelar ou redefinir as marcas de sinal.
uservalue id Especifica um identificador que é relatado novamente com a mensagem de sinalização. Esse identificador atua como um identificador que pode ser usado com outros comandos de sinal para referenciar essa configuração de sinal . Se omitido, o valor padrão será zero.

lpszFlags

Pode ser "wait", "notify", "test" ou uma combinação deles. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

O identificador de janela usado para notificação de mensagens de conclusão de comando também é usado para sinalizaçã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]

Confira também

MCI

Cadeias de caracteres de comando MCI

MM_MCISIGNAL