Metodo IVMRSurfaceAllocator::P repareSurface (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il PrepareSurface metodo prepara la superficie DirectDraw in modo che il fotogramma video successivo venga decodificato.

Sintassi

HRESULT PrepareSurface(
  [in] DWORD_PTR            dwUserID,
  [in] LPDIRECTDRAWSURFACE7 lpSurface,
  [in] DWORD                dwSurfaceFlags
);

Parametri

[in] dwUserID

Un cookie di DWORD_PTR definito dall'applicazione che identifica in modo univoco questa istanza di VMR da usare negli scenari in cui un'istanza del relatore allocatore viene usata con più istanze di VMR.

[in] lpSurface

Specifica la superficie DirectDraw

[in] dwSurfaceFlags

Parola doppia contenente i flag di superficie. Vedere la sezione Osservazioni.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Commenti

L'unico flag attualmente controllato da VMR è AM_GBF_NOTASYNCPOINT (0x00000002), che indica che non si sta per riempire il buffer con un punto di sincronizzazione (fotogramma chiave).

Requisiti

Vedi anche

Interfaccia IVMRSurfaceAllocator

Uso del renderer di missaggio video