Método IOverlay::GetClipList (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 GetClipList método recupera a lista de recortes.
Sintaxe
HRESULT GetClipList(
[out] RECT *pSourceRect,
[in] RECT *pDestinationRect,
[out] RGNDATA **ppRgnData
);
Parâmetros
[out] pSourceRect
Ponteiro para o retângulo do cliente delimitador.
[in] pDestinationRect
Ponteiro para o retângulo de destino.
[out] ppRgnData
Endereço de um ponteiro para o cabeçalho e os dados que descrevem o recorte. Se tiver êxito, libere a memória alocada chamando CoTaskMemFree.
Retornar valor
Retorna S_OK se tiver êxito. Se o método falhar, ele retornará um código de erro HRESULT .
Comentários
A implementação de IOverlay aloca a memória para os retângulos de recorte, pois pode variar de comprimento. O filtro que chama esse método deve liberar a memória (usando CoTaskMemFree) quando ele for concluído com ele.
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 |