CMediaType.ReallocFormatBuffer-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die ReallocFormatBuffer -Methode ordnet den Formatblock einer neuen Größe zu.

Syntax

BYTE* ReallocFormatBuffer(
   ULONG length
);

Parameter

length

Die für den Formatblock erforderliche neue Größe in Bytes. Muss größer sein als Null.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen Zeiger auf den neuen Block zurück. Andernfalls wird entweder ein Zeiger auf den alten Formatblock oder NULL zurückgegeben.

Bemerkungen

Diese Methode ordnet einen neuen Formatblock zu. Es kopiert so viel wie möglich des vorhandenen Formatblocks in den neuen Formatblock. Wenn der neue Block kleiner als der vorhandene Block ist, wird der vorhandene Formatblock abgeschnitten. Wenn der neue Block größer ist, ist der Inhalt des zusätzlichen Speicherplatzes nicht definiert. Sie werden nicht explizit auf 0 (null) festgelegt.

Die -Methode aktualisiert die Elemente cbFormat und pbFormat der AM_MEDIA_TYPE-Struktur .

Anforderungen

Anforderung	Wert
Header	Mtype.h (Einschließen von Streams.h)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CMediaType-Klasse