Freigeben über


CMediaType.AllocFormatBuffer-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 AllocFormatBuffer -Methode ordnet Arbeitsspeicher für den Formatblock zu.

Syntax

BYTE* AllocFormatBuffer(
   ULONG length
);

Parameter

length

Erforderliche Größe für den Formatblock in Bytes.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen Zeiger auf den neuen Block zurück. Andernfalls wird NULL zurückgegeben.

Bemerkungen

Wenn die Methode erfolgreich einen neuen Formatblock zuordnet, wird der vorhandene Formatblock freigegeben. Wenn die Zuordnung fehlschlägt, belässt die Methode den vorhandenen Formatblock.

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