MFCreateMediaBufferFromMediaType-Funktion (mfapi.h)
Ordnet einen Systemspeicherpuffer zu, der für einen angegebenen Medientyp optimal ist.
Syntax
HRESULT MFCreateMediaBufferFromMediaType(
[in] IMFMediaType *pMediaType,
[in] LONGLONG llDuration,
[in] DWORD dwMinLength,
[in] DWORD dwMinAlignment,
[out] IMFMediaBuffer **ppBuffer
);
Parameter
[in] pMediaType
Ein Zeiger auf die IMFMediaType-Schnittstelle des Medientyps.
[in] llDuration
Die Beispieldauer. Dieser Wert ist für Audioformate erforderlich.
[in] dwMinLength
Die Mindestgröße des Puffers in Bytes. Die tatsächliche Puffergröße kann größer sein. Geben Sie null an, um die Standardpuffergröße für den Medientyp zuzuweisen.
[in] dwMinAlignment
Die minimale Speicherausrichtung für den Puffer. Geben Sie null an, um die Standardspeicherausrichtung zu verwenden.
[out] ppBuffer
Empfängt einen Zeiger auf die IMFMediaBuffer-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.
Rückgabewert
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn das Format für Videoformate erkannt wird, erstellt die Funktion einen 2D-Puffer, der die IMF2DBuffer2-Schnittstelle implementiert. Andernfalls wird ein linearer Puffer erstellt. Um die IMF2DBuffer2-Schnittstelle abzurufen, rufen Sie QueryInterface für den in ppBuffer zurückgegebenen Zeiger auf. Wenn bei der QueryInterface-Methode ein Fehler auftritt, verwenden Sie die IMFMediaBuffer-Schnittstelle , um auf den Pufferspeicher zuzugreifen.
Bei Audioformaten ordnet die Funktion einen Puffer zu, der groß genug ist, um llDuration-Audiobeispiele zu enthalten, oder dwMinLength, je nachdem, welcher Wert größer ist.
Diese Funktion ordnet immer Systemspeicher zu. Verwenden Sie für Direct3D-Oberflächen die Funktion MFCreateDXGISurfaceBuffer oder MFCreateDXSurfaceBuffer .
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mfapi.h |
| Bibliothek | Mfplat.lib |
| DLL | Mfplat.dll |