MFCreateDXSurfaceBuffer-Funktion (mfapi.h)

Artikel
08/24/2023

Erstellt ein Medienpufferobjekt, das eine Direct3D 9-Oberfläche verwaltet.

Syntax

HRESULT MFCreateDXSurfaceBuffer(
  [in]  REFIID         riid,
  [in]  IUnknown       *punkSurface,
  [in]  BOOL           fBottomUpWhenLinear,
  [out] IMFMediaBuffer **ppBuffer
);

Parameter

[in] riid

Gibt den Typ der Direct3D 9-Oberfläche an. Derzeit muss dieser Wert IID_IDirect3DSurface9 werden.

[in] punkSurface

Ein Zeiger auf die IUnknown-Schnittstelle der DirectX-Oberfläche.

[in] fBottomUpWhenLinear

Bei TRUE kopiert die IMF2DBuffer::ContiguousCopyTo-Methode des Puffers den Puffer in ein Bottom-Up-Format. Das Bottom-Up-Format ist mit GDI für unkomprimierte RGB-Bilder kompatibel. Wenn dieser Parameter FALSE ist, kopiert die ContiguousCopyTo-Methode den Puffer in ein Top-Down-Format, das mit DirectX kompatibel ist.

Weitere Informationen zu Top-Down- und Bottom-Up-Bildern finden Sie unter Image Stride.

[out] ppBuffer

Empfängt einen Zeiger auf die IMFMediaBuffer-Schnittstelle . Der Aufrufer muss den Puffer freigeben.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Ungültiges Argument.

Hinweise

Diese Funktion erstellt ein Medienpufferobjekt, das einen Zeiger auf die in punkSurface angegebene Direct3D-Oberfläche enthält. Durch sperren des Puffers erhält der Aufrufer Zugriff auf den Oberflächenspeicher. Wenn das Pufferobjekt zerstört wird, gibt es die Oberfläche frei. Weitere Informationen zu Medienpuffern finden Sie unter Medienpuffer.

Hinweis Diese Funktion weist die Direct3D-Oberfläche selbst nicht zu.

Das von dieser Funktion erstellte Pufferobjekt macht auch die IMF2DBuffer-Schnittstelle verfügbar. Weitere Informationen finden Sie unter DirectX Surface Buffer.

Diese Funktion unterstützt keine DXGI-Oberflächen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfapi.h
Bibliothek	Evr.lib
DLL	Evr.dll

Weitere Informationen

DirectX Surface Buffer

Medienpuffer

Media Foundation-Funktionen

Freigeben über