IAVIStream::Read-Methode (vfw.h)

Die Read-Methode liest Daten aus einem Stream und kopiert sie in einen anwendungsdefiniertem Puffer. Wenn kein Puffer bereitgestellt wird, wird die Puffergröße bestimmt, die zum Abrufen des nächsten Datenpuffers erforderlich ist. Wird aufgerufen, wenn eine Anwendung die AVIStreamRead-Funktion verwendet.

Syntax

HRESULT Read(
  LONG   lStart,
  LONG   lSamples,
  LPVOID lpBuffer,
  LONG   cbBuffer,
  LONG   *plBytes,
  LONG   *plSamples
);

Parameter

lStart

Startbeispiel- oder Framenummer zum Lesen.

lSamples

Anzahl der zu lesenden Beispiele.

lpBuffer

Zeiger auf den anwendungsdefinierten Puffer, der die Streamdaten enthält. Sie können auch NULL angeben, um die erforderliche Größe des Puffers anzufordern. Viele Anwendungen gehen jedem Lesevorgang eine Abfrage für die Puffergröße voran, um zu ermitteln, wie groß ein Puffer benötigt wird.

cbBuffer

Größe des von lpBuffer angegebenen Puffers in Bytes.

plBytes

Zeiger auf einen Puffer, der die Anzahl der gelesenen Bytes empfängt.

plSamples

Zeiger auf einen Puffer, der die Anzahl der gelesenen Beispiele empfängt.

Rückgabewert

Gibt AVIERR_OK zurück, wenn erfolgreich oder AVIERR_BUFFERTOOSMALL, wenn der Puffer nicht groß genug ist, um die Daten aufzunehmen. Bei erfolgreicher Ausführung gibt Read auch einen Datenpuffer mit der Anzahl der im Puffer enthaltenen Frames (Beispiele) oder der erforderlichen Puffergröße in Bytes zurück.

Hinweise

Für in C++ geschriebene Handler verfügt Read über die folgende Syntax:

HRESULT Read(LONG lStart, LONG lSamples, 
    LPVOID lpBuffer, LONG cbBuffer, 
    LONG *plBytes, LONG *plSamples); 
 

Anforderungen

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

Weitere Informationen

Benutzerdefinierte Datei- und Streamhandlerschnittstellen

Benutzerdefinierte Datei- und Streamhandler