Método IEnumFilters::Next (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 Next método recupera o número especificado de filtros na sequência de enumeração.
Sintaxe
HRESULT Next(
[in] ULONG cFilters,
[out] IBaseFilter **ppFilter,
[out] ULONG *pcFetched
);
Parâmetros
[in] cFilters
Número de filtros a serem recuperados.
[out] ppFilter
Matriz de cFilters de tamanho que é preenchida com ponteiros de interface IBaseFilter . O chamador deve liberar as interfaces.
[out] pcFetched
Recebe o número de filtros recuperados. Pode ser NULL se cFilters for 1.
Valor retornado
| Valor | Descrição |
|---|---|
| S_FALSE | Não recuperou tantos filtros quanto solicitado. |
| S_OK | Êxito. |
| E_INVALIDARG | Argumento inválido. |
| E_POINTER | Argumento de ponteiro NULL. |
| VFW_E_ENUM_OUT_OF_SYNC | O grafo foi alterado e agora está inconsistente com o enumerador . |
Comentários
Se o método for bem-sucedido, todos os ponteiros IBaseFilter terão contagens de referência pendentes. Certifique-se de liberá-los quando terminar.
Se o grafo de filtro for alterado (por exemplo, o aplicativo removerá um filtro), o enumerador não será mais consistente com o grafo e o método retornará VFW_E_ENUM_OUT_OF_SYNC. Descarte todos os dados obtidos de chamadas anteriores para o enumerador, pois eles podem ser inválidos. Atualize o enumerador chamando o método IEnumFilters::Reset . Em seguida, você pode chamar o Next método com segurança.
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 |