Método IDDrawExclModeVideoCallback::OnUpdateOverlay (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 OnUpdateOverlay método informa o aplicativo quando a superfície de sobreposição do vídeo está prestes a se tornar visível, invisível, alterar o tamanho ou alterar a posição, para que o aplicativo possa repintar sua janela adequadamente.

Sintaxe

HRESULT OnUpdateOverlay(
  [in] BOOL       bBefore,
  [in] DWORD      dwFlags,
  [in] BOOL       bOldVisible,
  [in] const RECT *prcOldSrc,
  [in] const RECT *prcOldDest,
  [in] BOOL       bNewVisible,
  [in] const RECT *prcNewSrc,
  [in] const RECT *prcNewDest
);

Parâmetros

[in] bBefore

Valor booliano que especifica se a chamada está sendo feita antes ou depois da alteração relacionada à sobreposição. TRUE especifica antes, FALSE especifica depois.

[in] dwFlags

Valor da enumeração AM_OVERLAY_NOTIFY_FLAGS que especifica o que está prestes a mudar ou o que mudou.

[in] bOldVisible

Valor booliano que especifica se a janela antiga está visível. TRUE significa que a janela antiga está visível.

[in] prcOldSrc

Ponteiro para o retângulo que representa a posição de origem antiga da superfície DirectDraw.

[in] prcOldDest

Ponteiro para o retângulo que representa a posição de destino antiga do retângulo na superfície de sobreposição.

[in] bNewVisible

Booliano especificando se a nova janela está visível. TRUE significa que a nova janela está visível.

[in] prcNewSrc

Ponteiro para o retângulo que representa a nova posição de origem da superfície DirectDraw.

[in] prcNewDest

Ponteiro para o retângulo que representa a nova posição de destino do retângulo na superfície de sobreposição.

Retornar valor

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

Código de retorno	Descrição
S_OK	Êxito.
E_INVALIDARG	Parâmetro inválido.

Comentários

O aplicativo deve chamar esse método uma vez antes que a alteração relacionada à sobreposição ocorra e uma vez após a conclusão das alterações. Na chamada antes da alteração, a alteração de sobreposição não acontece até que o aplicativo conclua a execução desse método.

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	strmif.h (inclua Dshow.h)
Biblioteca	Strmiids.lib

Confira também

Códigos de erro e êxito

IDDrawExclModeVideoCallback Interface