MFCreateDXGISurfaceBuffer-Funktion (mfapi.h)

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

Syntax

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

Die Parameter

[in] riid

Identifiziert den Typ der DXGI-Oberfläche. Dieser Wert muss IID_ID3D11Texture2D oder IID_ID3D12Resource sein.

[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 Unterressource zugeordnet.

[in] fBottomUpWhenLinear

Wenn 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, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

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

• IMF2DBuffer-
• IMF2DBuffer2
• IMFDXGIBuffer
• IMFMediaBuffer-

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows 8 [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform	Fenster
Header	mfapi.h
Library	Mfplat.lib
DLL	Mfplat.dll

Siehe auch

Media Foundation-Funktionen