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 |