Compartilhar via


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

Confira também

Funções AVIFile

Funções e macros do AVIFile