Freigeben über


CMediaType.SetFormat-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SetFormat -Methode initialisiert den Formatblock.

Syntax

BOOL SetFormat(
   BYTE  *pFormat,
   ULONG length
);

Parameter

pFormat

Zeiger auf einen Speicherblock, der den Formatblock enthält.

length

Länge des Formatblocks in Bytes.

Rückgabewert

Gibt TRUE bei erfolgreicher Ausführung oder FALSE zurück, wenn ein Fehler aufgetreten ist.

Bemerkungen

Diese Methode weist Arbeitsspeicher für den Formatblock zu und kopiert den von pFormat angegebenen Puffer in den neuen Formatblock. Wenn der Medientyp bereits einen Formatblock enthält, wird der alte freigegeben. Die -Methode legt auch das cbFormat-Element der AM_MEDIA_TYPE-Struktur fest.

Um den Formattyp festzulegen, rufen Sie die CMediaType::SetFormatType-Methode auf.

Anforderungen

Anforderung Wert
Header
Mtype.h (streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CMediaType-Klasse