AVIStreamRead-Funktion (vfw.h)

  • Artikel

Die AVIStreamRead-Funktion liest Audio-, Video- oder andere Daten aus einem Stream entsprechend dem Streamtyp.

Syntax

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

Parameter

pavi

Handle für einen geöffneten Stream.

lStart

Erstes zu lesende Beispiel.

lSamples

Anzahl der zu lesenden Beispiele. Sie können auch den Wert AVISTREAMREAD_CONVENIENT angeben, damit der Streamhandler die Anzahl der zu lesenden Beispiele bestimmen kann.

lpBuffer

Zeiger auf einen Puffer, der die Daten enthält.

cbBuffer

Größe des Puffers in Bytes, auf den lpBuffer verweist.

plBytes

Zeiger auf einen Puffer, der die Anzahl von Bytes der Daten empfängt, die in dem Puffer geschrieben wurden, auf den von lpBuffer verwiesen wird. Dieser Wert kann NULL sein.

plSamples

Zeiger auf einen Puffer, der die Anzahl der Stichproben empfängt, die in den Puffer geschrieben wurden, auf den von lpBuffer verwiesen wird. Dieser Wert kann NULL sein.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
AVIERR_BUFFERTOOSMALL
 Die Puffergröße cbBuffer war kleiner als eine einzelne Stichprobe von Daten.
AVIERR_MEMORY
 Es war nicht genügend Arbeitsspeicher vorhanden, um den Lesevorgang abzuschließen.
AVIERR_FILEREAD
 Beim Lesen der Datei ist ein Datenträgerfehler aufgetreten.

Hinweise

Wenn lpBufferNULL ist, liest diese Funktion keine Daten. Es gibt Informationen über die Größe der Daten zurück, die gelesen werden würden.

Das Argument pavi ist ein Zeiger auf eine IAVIStream-Schnittstelle .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vfw.h
Bibliothek Vfw32.lib
DLL Avifil32.dll

Weitere Informationen

AVIFile-Funktionen

AVIFile-Funktionen und -Makros