Método IBasicVideo::SetDestinationPosition (control.h)

[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 SetDestinationPosition método define o retângulo de destino.

Sintaxe

HRESULT SetDestinationPosition(
  [in] long Left,
  [in] long Top,
  [in] long Width,
  [in] long Height
);

Parâmetros

[in] Left

Especifica a coordenada x, em pixels.

[in] Top

Especifica a coordenada y, em pixels.

[in] Width

Especifica a largura, em pixels.

[in] Height

Especifica a altura, em pixels.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno	Descrição
E_INVALIDARG	Argumento inválido. Largura e Altura devem ser maiores que zero.
S_OK	O método foi bem-sucedido.
VFW_E_NOT_CONNECTED	O renderizador de vídeo não está conectado.

Comentários

Esse método tem o mesmo efeito que chamar individualmente os métodos IBasicVideo::p ut_DestinationLeft, IBasicVideo::p ut_DestinationTop, IBasicVideo::p ut_DestinationWidth e IBasicVideo::p ut_DestinationHeight .

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]
Plataforma de Destino	Windows
Cabeçalho	control.h (inclua Dshow.h)
Biblioteca	Strmiids.lib

Confira também

Códigos de erro e êxito

IBasicVideo Interface