Método IAVIStream::Read (vfw.h)
O método Read lê dados de um fluxo e os copia para um buffer definido pelo aplicativo. Se nenhum buffer for fornecido, ele determinará o tamanho do buffer necessário para recuperar o próximo buffer de dados. Chamado quando um aplicativo usa a função AVIStreamRead .
Sintaxe
HRESULT Read(
LONG lStart,
LONG lSamples,
LPVOID lpBuffer,
LONG cbBuffer,
LONG *plBytes,
LONG *plSamples
);
Parâmetros
lStart
Iniciando o exemplo ou o número de quadro a ser lido.
lSamples
Número de exemplos a serem lidos.
lpBuffer
Ponteiro para o buffer definido pelo aplicativo para conter os dados de fluxo. Você também pode especificar NULL para solicitar o tamanho necessário do buffer. Muitos aplicativos precedem cada operação de leitura com uma consulta para o tamanho do buffer para ver o tamanho de um buffer.
cbBuffer
Tamanho, em bytes, do buffer especificado por lpBuffer.
plBytes
Ponteiro para um buffer que recebe o número de bytes lidos.
plSamples
Ponteiro para um buffer que recebe o número de exemplos lidos.
Valor retornado
Retorna AVIERR_OK se tiver êxito ou AVIERR_BUFFERTOOSMALL se o buffer não for grande o suficiente para manter os dados. Se tiver êxito, Read também retornará um buffer de dados com o número de quadros (exemplos) incluídos no buffer ou o tamanho do buffer necessário, em bytes.
Comentários
Para manipuladores escritos em C++, Read tem a seguinte sintaxe:
HRESULT Read(LONG lStart, LONG lSamples,
LPVOID lpBuffer, LONG cbBuffer,
LONG *plBytes, LONG *plSamples);
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 |
Confira também
Interfaces de manipulador de fluxo e arquivos personalizados