Função AVIStreamFindSample (vfw.h)
A função AVIStreamFindSample retorna a posição de um exemplo (quadro-chave, quadro não vazio ou quadro que contém uma alteração de formato) em relação à posição especificada.
Essa função substitui a função obsoleta AVIStreamFindKeyFrame .
Sintaxe
LONG AVIStreamFindSample(
PAVISTREAM pavi,
LONG lPos,
LONG lFlags
);
Parâmetros
pavi
Manipule para um fluxo aberto.
lPos
Quadro inicial para a pesquisa.
lFlags
Sinalizadores que designam o tipo de quadro a ser localizado, a direção no fluxo a ser pesquisado e o tipo de informações de retorno. Os sinalizadores a seguir são definidos.
| Valor | Significado |
|---|---|
| FIND_ANY | Localiza um quadro não vazio. Esse sinalizador substitui o sinalizador SEARCH_ANY. |
| FIND_KEY | Localiza um quadro-chave. Esse sinalizador substitui o sinalizador SEARCH_KEY. |
| FIND_FORMAT | Localiza uma alteração de formato. |
| FIND_NEXT | Localiza a amostra mais próxima, quadro ou alteração de formato pesquisando para frente. O exemplo atual está incluído na pesquisa. Use esse sinalizador com o sinalizador FIND_ANY, FIND_KEY ou FIND_FORMAT. Esse sinalizador substitui o sinalizador SEARCH_FORWARD. |
| FIND_PREV | Localiza a amostra mais próxima, quadro ou alteração de formato pesquisando para trás. O exemplo atual está incluído na pesquisa. Use esse sinalizador com o sinalizador FIND_ANY, FIND_KEY ou FIND_FORMAT. Esse sinalizador substitui os sinalizadores SEARCH_NEAREST e SEARCH_BACKWARD. |
| FIND_FROM_START | Localiza a primeira alteração de exemplo, quadro ou formato a partir do início do fluxo. Use esse sinalizador com o sinalizador FIND_ANY, FIND_KEY ou FIND_FORMAT. |
Valor retornado
Retorna a posição do quadro encontrado ou -1 se a pesquisa não for bem-sucedida.
Comentários
Os sinalizadores FIND_KEY, FIND_ANY e FIND_FORMAT são mutuamente exclusivos, assim como os sinalizadores FIND_NEXT e FIND_PREV.
O pavi de argumento contém um ponteiro para uma interface IAVIStream .
Requisitos
| 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 | vfw.h |
| Biblioteca | Vfw32.lib |
| DLL | Avifil32.dll |