MFCreateMediaBufferFromMediaType-Funktion (mfapi.h)

  • Artikel

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

Weitere Informationen

Media Foundation-Funktionen