Método IOverlayNotify::OnPositionChange (strmif.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 OnPositionChange método fornece uma notificação de que a posição foi alterada.

Sintaxe

HRESULT OnPositionChange(
  [in] const RECT *pSourceRect,
  [in] const RECT *pDestinationRect
);

Parâmetros

[in] pSourceRect

Ponteiro para o retângulo de vídeo de origem.

[in] pDestinationRect

Ponteiro para o retângulo de vídeo de destino. Observe que isso não é recortado na área de exibição visível.

Retornar valor

Retorna S_OK se tiver êxito. Se o método falhar, ele retornará um código de erro HRESULT .

Comentários

Esse método é um retorno de chamada destinado ao uso por cartões de sobreposição de hardware que não desejam a despesa de atualizações de recorte síncronas e só querem saber quando as posições de vídeo de origem ou de destino mudam.

Ao contrário do método IOverlayNotify::OnClipChange , esse método não é chamado na sincronização com a janela mudando, mas, sim, em algum momento após a janela ter sido alterada (basicamente no tempo com WM_SIZE mensagens recebidas). Portanto, isso é adequado para cartões de sobreposição que não inlay seus dados para o buffer de quadros.

Requisitos

Confira também

Códigos de erro e êxito

IOverlayNotify Interface