comando where

O comando where recupera o retângulo especificando a área de origem ou destino. Esse retângulo foi especificado usando o comando put . Os dispositivos de vídeo digital e sobreposição de vídeo reconhecem esse comando.

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

_stprintf_s(
  lpszCommand, 
  TEXT("where %s %s %s"), 
  lpszDeviceID, 
  lpszRequestRect, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

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

lpszRequestRect

Sinalizador que identifica o retângulo cujas dimensões são recuperadas. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando where e os sinalizadores usados por cada tipo.

Valor Significado Significado
digitalvideo destinationdestination maxframeframe maxsource fonte maxvideovideo maxwindowwindow max
overlay destinationframe sourcevideo

A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszRequestRect e seus significados.

Valor Significado
destino Recupera o deslocamento e a extensão de destino. Para dispositivos de sobreposição de vídeo, o retângulo de destino define a área da área do cliente da janela de exibição que exibe os dados da imagem do buffer de quadros.
destination max Recupera o tamanho atual do retângulo do cliente.
frame Recupera o deslocamento e a extensão do retângulo do buffer de quadro. O retângulo do buffer de quadros define a área do buffer de quadros que recebe dados de vídeo de entrada. As imagens do retângulo "vídeo" são dimensionadas para essa região.
frame max Retorna o tamanho máximo do buffer de quadros.
source Recupera o deslocamento e a extensão de origem. Para dispositivos de sobreposição de vídeo, o retângulo de origem define a região do buffer de quadros exibida na janela de destino. O dispositivo usa esse retângulo para cortar a imagem antes de ser alongada para ajustar o retângulo de destino na tela.
source max Recupera o tamanho máximo do buffer de quadros.
video Recupera o deslocamento e a extensão do retângulo de vídeo. O retângulo de vídeo define a região dos dados de vídeo de entrada que são transferidos para o buffer de quadros.
máximo de vídeo Retorna o tamanho máximo da entrada.
janela Recupera o tamanho e a posição atuais do quadro da janela de exibição.
máximo da janela Recupera o tamanho de toda a exibição.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital, "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retorna um retângulo no parâmetro lpszReturnString da função mciSendString . O retângulo descreve a área especificada no parâmetro lpszRequestRect desse comando. O retângulo é especificado como X1 Y1 X2 Y2. As coordenadas X1 Y1 especificam o canto superior esquerdo do retângulo e as coordenadas X2 Y2 especificam a largura e a altura.

Exemplos

O comando a seguir retorna o retângulo de exibição do dispositivo "movie".

where movie destination

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

put