MFCreateDXGISurfaceBuffer-Funktion (mfapi.h)

Artikel
08/24/2023

Erstellt einen Medienpuffer zum Verwalten einer DxGI-Oberfläche (Microsoft DirectX Graphics Infrastructure).

Syntax

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

Parameter

[in] riid

Gibt den Typ der DXGI-Oberfläche an. Dieser Wert muss IID_ID3D11Texture2D werden.

[in] punkSurface

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

[in] uSubresourceIndex

Der nullbasierte Index einer Unterressource der Oberfläche. Das Medienpufferobjekt ist dieser Unterquelle zugeordnet.

[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 Direct3D 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

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das zurückgegebene Pufferobjekt unterstützt die folgenden Schnittstellen:

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

Freigeben über