Método CBaseControlVideo.GetDestinationPosition

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O GetDestinationPosition método recupera o retângulo de destino em uma operação atômica.

Sintaxe

HRESULT GetDestinationPosition(
   long *pLeft,
   long *pTop,
   long *pWidth,
   long *pHeight
);

Parâmetros

pLeft

Ponteiro para a coordenada esquerda do retângulo de destino.

pTop

Ponteiro para a coordenada superior do retângulo de destino.

Pwidth

Ponteiro para a largura do retângulo de destino.

pHeight

Ponteiro para a altura do retângulo de destino.

Retornar valor

Retorna um valor HRESULT que depende da implementação; pode ser um dos valores a seguir ou outros valores não listados.

Código de retorno	Descrição
E_FAIL	Falha.
E_POINTER	Argumento de ponteiro NULL.
VFW_E_NOT_CONNECTED	A operação não pode ser executada porque os pinos não estão conectados.
NOERROR	Êxito.

Comentários

Essa função membro pode ser usada no lugar de chamadas separadas para as funções de membro CBaseControlVideo::get_DestinationLeft, CBaseControlVideo::get_DestinationTop, CBaseControlVideo::get_DestinationWidth e CBaseControlVideo::get_DestinationHeight . Um aplicativo pode alterar os retângulos de origem e destino do vídeo por meio da interface IBasicVideo . O retângulo de origem afeta qual seção da fonte de vídeo nativa aparecerá na exibição; o retângulo de destino afeta onde o vídeo será exibido quando reproduzido. O retângulo de destino é relativo à área do cliente da janela em que está sendo reproduzido. O canto superior esquerdo da janela é a coordenada (0,0).

Requisitos

Requisito	Valor
parâmetro	Ctlutil.h (inclua Streams.h)
Biblioteca	Strmbase.lib (builds de varejo); Strmbasd.lib (builds de depuração)

Confira também

Classe CBaseControlVideo