Funzione MFCreateDXSurfaceBuffer (mfapi.h)

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.

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.

Questa funzione non supporta le superfici DXGI.

Requisiti

Vedi anche

Buffer di superficie DirectX

Buffer multimediali

Funzioni di Media Foundation