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 |
|---|---|
|
Êxito. |
|
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 |