Função AVIStreamRead (vfw.h)

A função AVIStreamRead lê áudio, vídeo ou outros dados de um fluxo de acordo com o tipo de fluxo.

Sintaxe

HRESULT AVIStreamRead(
  PAVISTREAM pavi,
  LONG       lStart,
  LONG       lSamples,
  LPVOID     lpBuffer,
  LONG       cbBuffer,
  LONG       *plBytes,
  LONG       *plSamples
);

Parâmetros

pavi

Manipule para um fluxo aberto.

lStart

Primeiro exemplo a ser lido.

lSamples

Número de exemplos a serem lidos. Você também pode especificar o valor AVISTREAMREAD_CONVENIENT para permitir que o manipulador de fluxo determine o número de exemplos a serem lidos.

lpBuffer

Ponteiro para um buffer para conter os dados.

cbBuffer

Tamanho, em bytes, do buffer apontado por lpBuffer.

plBytes

Ponteiro para um buffer que recebe o número de bytes de dados gravados no buffer referenciado por lpBuffer. Esse valor pode ser NULL.

plSamples

Ponteiro para um buffer que recebe o número de exemplos gravados no buffer referenciado por lpBuffer. Esse valor pode ser NULL.

Retornar valor

Retorna zero se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
AVIERR_BUFFERTOOSMALL	O tamanho do buffer cbBuffer era menor do que um único exemplo de dados.
AVIERR_MEMORY	Não havia memória suficiente para concluir a operação de leitura.
AVIERR_FILEREAD	Ocorreu um erro de disco ao ler o arquivo.

Comentários

Se lpBuffer for NULL, essa função não lerá nenhum dado; ele retorna informações sobre o tamanho dos dados que seriam lidos.

O argumento pavi é um ponteiro para uma interface IAVIStream .

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	vfw.h
Biblioteca	Vfw32.lib
DLL	Avifil32.dll

Confira também

Funções AVIFile

Funções e macros do AVIFile