AVIFileReadData-Funktion (vfw.h)

Die FUNKTION AVIFileReadData liest optionale Headerdaten, die für die gesamte Datei gelten, z. B. Autoren- oder Copyrightinformationen.

Syntax

HRESULT AVIFileReadData(
  PAVIFILE pfile,
  DWORD    ckid,
  LPVOID   lpData,
  LONG     *lpcbData
);

Parameter

pfile

Handle für eine geöffnete AVI-Datei.

ckid

RIFF-Blockbezeichner (vierstelligen Code) der Daten.

lpData

Zeiger auf den Puffer, der verwendet wird, um die gelesenen Daten zurückzugeben.

lpcbData

Zeiger auf einen Speicherort, der die Größe des Speicherblocks angibt, auf den von lpData verwiesen wird. Wenn die Daten erfolgreich gelesen wurden, wird der Wert geändert, um die Menge der gelesenen Daten anzugeben.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt. Der Rückgabewert AVIERR_NODATA gibt an, dass Daten mit dem angeforderten Blockbezeichner nicht vorhanden sind.

Hinweise

Die optionalen Headerinformationen sind benutzerdefinierte und weisen kein festgelegtes Format auf.

Das Argument pfile ist ein Zeiger auf eine IAVIFile-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