Funzione MFCreateDXSurfaceBuffer (mfapi.h)

Articolo
08/24/2023

Crea un oggetto buffer multimediale che gestisce una superficie Direct3D 9.

Sintassi

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

Parametri

[in] riid

Identifica il tipo di superficie Direct3D 9. Attualmente questo valore deve essere IID_IDirect3DSurface9.

[in] punkSurface

Puntatore all'interfaccia IUnknown dell'area DirectX.

[in] fBottomUpWhenLinear

Se TRUE, il metodo FMI2DBuffer::ContiguousCopyTo copia il buffer in un formato inferiore. Il formato inferiore è compatibile con GDI per le immagini RGB non compresse. Se questo parametro è FALSE, il metodo ContiguousCopyTo copia il buffer in un formato top-down, compatibile con DirectX.

Per altre informazioni sulle immagini in alto verso il basso rispetto alle immagini in basso, vedere Image Stride.

[out] ppBuffer

Riceve un puntatore all'interfaccia FMMediaBuffer . Il chiamante deve rilasciare il buffer.

Valore restituito

La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Argomento non valido.

Commenti

Questa funzione crea un oggetto buffer multimediale che contiene un puntatore alla superficie Direct3D specificata in punkSurface. Il blocco del buffer consente al chiamante di accedere alla memoria di superficie. Quando l'oggetto buffer viene distrutto, rilascia la superficie. Per altre informazioni sui buffer multimediali, vedere Buffer multimediali.

Nota Questa funzione non alloca la superficie Direct3D stessa.

L'oggetto buffer creato da questa funzione espone anche l'interfaccia FM2DBuffer . Per altre informazioni, vedere DirectX Surface Buffer.

Questa funzione non supporta le superfici DXGI.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfapi.h
Libreria	Evr.lib
DLL	Evr.dll

Vedi anche

Buffer di superficie DirectX

Buffer multimediali

Funzioni di Media Foundation

Condividi tramite