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 |
|
| Bibliothek |
|