IAVIStream::ReadFormat-Methode (vfw.h)

Die ReadFormat-Methode ruft Formatinformationen aus einem Stream ab. Füllt eine Struktur mit den Daten in einem anwendungsdefiniertem Puffer aus und gibt sie zurück. Wenn kein Puffer bereitgestellt wird, bestimmt die Puffergröße, die zum Abrufen des Puffers von Formatdaten erforderlich ist. Wird aufgerufen, wenn eine Anwendung die AVIStreamReadFormat-Funktion verwendet.

Syntax

HRESULT ReadFormat(
  LONG   lPos,
  LPVOID lpFormat,
  LONG   *lpcbFormat
);

Parameter

lPos

Position des Beispiels oder Rahmens.

lpFormat

Zeiger auf den Puffer für die Formatdaten. Geben Sie NULL an, um die erforderliche Größe des Puffers anzufordern.

lpcbFormat

Zeiger auf einen Puffer, der die Größe des durch lpFormat angegebenen Puffers in Bytes empfängt. Wenn diese Methode aufgerufen wird, gibt der Inhalt dieses Parameters die Größe des puffers an, der von lpFormat angegeben wird. Wenn diese Methode die Steuerung an die Anwendung zurückgibt, gibt der Inhalt dieses Parameters die Menge der gelesenen Daten oder die erforderliche Größe des Puffers an.

Rückgabewert

Gibt das von OLE definierte HRESULT zurück.

Hinweise

Der Typ der in einem Stream gespeicherten Daten bestimmt die Formatinformationen und die Struktur, die die Formatinformationen enthält. Ein Streamhandler sollte alle relevanten Formatinformationen in dieser Struktur zurückgeben, einschließlich Paletteninformationen, wenn das Format eine Palette verwendet. Ein Streamhandler sollte keine Datenstromdaten mit der -Struktur zurückgeben.

Standardvideostreamhandler stellen Formatinformationen in einer BITMAPINFOHEADER-Struktur bereit. Standard-Audiodatenstromhandler stellen Formatinformationen in einer PCMWAVEFORMAT-Struktur bereit. Andere Datenströme können andere Strukturen verwenden, die die Datenstromdaten beschreiben.

Für in C++ geschriebene Handler weist ReadFormat die folgende Syntax auf:

HRESULT ReadFormat(LONG lPos, LPVOID lpFormat, 
    LONG *lpcbFormat) 
 

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

Weitere Informationen

Benutzerdefinierte Datei- und Stream handlerschnittstellen

Benutzerdefinierte Datei- und Stream handler