comando MCI_WHERE

O comando MCI_WHERE obtém o retângulo de recorte para o dispositivo de vídeo. Os dispositivos de vídeo digital e de sobreposição de vídeo reconhecem esse comando. Os membros superior e esquerdo do RECT retornado contêm a origem do retângulo de recorte e os membros direito e inferior contêm a largura e a altura do retângulo de recorte. (Este não é o uso padrão dos membros direito e inferior .)

Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WHERE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpQuery
);

Parâmetros

wDeviceID

Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT ou, para dispositivos de vídeo digital, MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpQuery

Ponteiro para uma estrutura MCI_GENERIC_PARMS . (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Valor Retornado

Retorna zero se tiver êxito ou um erro de outra forma.

Comentários

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo digitalvideo :

MCI_DGV_WHERE_DESTINATION

Obtém uma descrição da região retangular usada para exibir vídeos e imagens na área do cliente da janela atual.

MCI_DGV_WHERE_FRAME

Obtém uma descrição da região retangular do buffer de quadro no qual as imagens do retângulo de vídeo são dimensionadas. As coordenadas do retângulo são colocadas no membro rc da estrutura identificada por lpQuery.

MCI_DGV_WHERE_MAX

Quando usado com MCI_DGV_WHERE_DESTINATION ou MCI_DGV_WHERE_SOURCE, o retângulo retornado indica a largura e a altura máximas da região especificada. Quando usado com MCI_DGV_WHERE_WINDOW, o retângulo retornado indica o tamanho de toda a exibição.

MCI_DGV_WHERE_SOURCE

Obtém uma descrição da região retangular (cortada do buffer de quadro) que é estendida para se ajustar ao retângulo de destino na tela.

MCI_DGV_WHERE_VIDEO

Obtém uma descrição da região retangular cortada da origem da apresentação para preencher o retângulo de quadro no buffer de quadros. As coordenadas do retângulo são colocadas no membro rc da estrutura identificada por lpQuery.

MCI_DGV_WHERE_WINDOW

Obtém uma descrição do quadro de janela de exibição.

Para dispositivos de vídeo digital, o parâmetro lpQuery aponta para uma estrutura MCI_DGV_WHERE_PARMS . A estrutura MCI_DGV_WHERE_PARMS é idêntica à estrutura de MCI_DGV_RECT_PARMS .

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo de sobreposição :

MCI_OVLY_WHERE_DESTINATION

Obtém o retângulo de exibição de destino. As coordenadas do retângulo são colocadas no membro rc da estrutura identificada por lpQuery.

MCI_OVLY_WHERE_FRAME

Obtém o retângulo de quadro de sobreposição. As coordenadas do retângulo são colocadas no membro rc da estrutura identificada por lpQuery.

MCI_OVLY_WHERE_SOURCE

Obtém o retângulo de origem. As coordenadas do retângulo são colocadas no membro rc da estrutura identificada por lpQuery.

MCI_OVLY_WHERE_VIDEO

Obtém o retângulo de vídeo. As coordenadas do retângulo são colocadas no membro rc da estrutura identificada por lpQuery.

Para dispositivos de sobreposição de vídeo, o parâmetro lpQuery aponta para uma estrutura MCI_OVLY_RECT_PARMS .

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]
Cabeçalho	Mmsystem.h (inclua Windows.h)

Confira também

MCI

Comandos MCI