AVIStreamRead-Funktion (vfw.h)
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 |
|---|---|
|
Die Puffergröße cbBuffer war kleiner als eine einzelne Stichprobe von Daten. |
|
Es war nicht genügend Arbeitsspeicher vorhanden, um den Lesevorgang abzuschließen. |
|
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 |